Compartilhar via

New-AzPublicIpAddress

Módulo:
Az.Network Module

Cria um endereço IP público.

Sintaxe

Default (Padrão) 

New-AzPublicIpAddress
    [-Name <String>]
    -ResourceGroupName <String>
    -Location <String>
    [-EdgeZone <String>]
    [-Sku <String>]
    [-Tier <String>]
    -AllocationMethod <String>
    [-IpAddressVersion <String>]
    [-DomainNameLabel <String>]
    [-DomainNameLabelScope <PSDomainNameLabelScopeType>]
    [-IpTag <PSPublicIpTag[]>]
    [-PublicIpPrefix <PSPublicIpPrefix>]
    [-DdosProtectionMode <String>]
    [-DdosProtectionPlanId <String>]
    [-ReverseFqdn <String>]
    [-IdleTimeoutInMinutes <Int32>]
    [-Zone <String[]>]
    [-IpAddress <String>]
    [-Tag <Hashtable>]
    [-Force]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet New-AzPublicIpAddress cria um endereço IP público.

Exemplos

Exemplo 1: Criar um novo endereço IP público

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $___location

Esse comando cria um novo recurso de endereço IP público. Um registro DNS é criado para $dnsPrefix.$___location.cloudapp.azure.com apontando para o endereço IP público desse recurso. Um endereço IP público é alocado imediatamente para esse recurso, pois o -AllocationMethod é especificado como "Estático". Se for especificado como 'Dinâmico', um endereço IP público será alocado somente quando você iniciar (ou criar) o recurso associado (como uma VM ou balanceador de carga).

Exemplo 2: criar um endereço IP público com um FQDN reverso

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $___location -ReverseFqdn $customFqdn

Esse comando cria um novo recurso de endereço IP público. Com o parâmetro -ReverseFqdn, o Azure cria um registro DNS PTR (pesquisa reversa) para o endereço IP público alocado para esse recurso, apontando para o $customFqdn especificado no comando. Como pré-requisito, o $customFqdn (digamos webapp.contoso.com) deve ter um registro CNAME DNS (pesquisa avançada) apontando para $dnsPrefix.$___location.cloudapp.azure.com.

Exemplo 3: criar um novo endereço IP público com IpTag

$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $___location -IpTag $ipTag

Esse comando cria um novo recurso de endereço IP público. Um registro DNS é criado para $dnsPrefix.$___location.cloudapp.azure.com apontando para o endereço IP público desse recurso. Um endereço IP público é alocado imediatamente para esse recurso, pois o -AllocationMethod é especificado como "Estático". Se for especificado como 'Dinâmico', um endereço IP público será alocado somente quando você iniciar (ou criar) o recurso associado (como uma VM ou balanceador de carga). Um Iptag é usado para especificar as Marcas associadas ao recurso. O Iptag pode ser especificado usando New-AzPublicIpTag e passado como entrada por -IpTags.

Exemplo 4: Criar um novo endereço IP público a partir de um prefixo

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $___location -PublicIpPrefix $publicIpPrefix -Sku Standard

Esse comando cria um novo recurso de endereço IP público. Um registro DNS é criado para $dnsPrefix.$___location.cloudapp.azure.com apontando para o endereço IP público desse recurso. Um endereço IP público é alocado imediatamente para esse recurso do publicIpPrefix especificado. Essa opção só tem suporte para o Sku 'Standard' e o AllocationMethod 'Estático'.

Exemplo 5: Criar um endereço IP público específico com base em um prefixo BYOIP

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -Location $___location -IpAddress 0.0.0.0 -PublicIpPrefix $publicIpPrefix -Sku Standard

Esse comando cria um novo recurso de endereço IP público com IP específico. O NRP verificaria se o IP especificado está dentro do PublicIpPrefix e se o PublicIpPrefix determinado é BYOIP PublicIpPrefix. o endereço IP público especificado é alocado imediatamente para esse recurso do publicIpPrefix especificado. Essa opção só tem suporte para o Sku 'Standard' e 'Static' AllocationMethod e BYOIP PublicIpPrefix.

Exemplo 6: Criar um novo endereço IP público global

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $domainNameLabel -Location $___location -Sku Standard -Tier Global

Esse comando cria um novo recurso de endereço IP público global. Um registro DNS é criado para $dnsPrefix.$___location.cloudapp.azure.com apontando para o endereço IP público desse recurso. Um endereço IP público global é alocado imediatamente para esse recurso. Essa opção só tem suporte para o Sku 'Standard' e o AllocationMethod 'Estático'.

Exemplo 7: Criar um endereço IP público com um DomainNameLabelScope

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $___location

Esse comando cria um novo recurso de endereço IP público. Com o parâmetro -DomainNameLabelScope, o Azure cria um registro DNS com um valor de hash no FQDN para o endereço IP público alocado para esse recurso com a política sugerida por $hasedReusePolicy.

Parâmetros

-AllocationMethod

Especifica o método com o qual alocar o endereço IP público. Os valores aceitáveis para esse parâmetro são: Estático ou Dinâmico.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:Dynamic, Static
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-AsJob

Executar cmdlet em segundo plano

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DdosProtectionMode

O DdosProtectionMode a ser usado para o endereço IP público

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:VirtualNetworkInherited, Enabled, Disabled
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DdosProtectionPlanId

A ID do DdosProtectionPlan a ser anexada ao endereço IP público

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DomainNameLabel

Especifica o nome DNS relativo para um endereço IP público.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DomainNameLabelScope

Especifica o nome HashedReusePolicy para DNS para um endereço IP público.

Propriedades do parâmetro

Tipo:

Nullable<T>[PSDomainNameLabelScopeType]

Valor padrão:None
Valores aceitos:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-EdgeZone

O nome do local estendido.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IdleTimeoutInMinutes

Especifica o tempo limite ocioso, em minutos.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IpAddress

Especifica o endereço IP ao criar um publicIpAddress BYOIP.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IpAddressVersion

Especifica a versão do endereço IP.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:IPv4, IPv6
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IpTag

Lista de IpTag.

Propriedades do parâmetro

Tipo:

PSPublicIpTag[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Location

Especifica a região na qual criar um endereço IP público.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Especifica o nome do endereço IP público que esse cmdlet cria.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:NomeDoRecurso

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-PublicIpPrefix

Especifica o PSPublicIpPrefix do qual alocar o endereço IP público.

Propriedades do parâmetro

Tipo:PSPublicIpPrefix
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceGroupName

Especifica o nome do grupo de recursos no qual criar um endereço IP público.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ReverseFqdn

Especifica um FQDN (nome de domínio totalmente qualificado) reverso.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Sku

O nome do Sku de IP público.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:Basic, Standard, StandardV2
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Tag

Pares chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; key1=$null; key2="value2"}

Propriedades do parâmetro

Tipo:Hashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Tier

A camada de Sku de IP público.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:Regional, Global
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Zone

Uma lista de zonas de disponibilidade que denotam o IP alocado para o recurso precisa vir.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

PSPublicIpTag

PSPublicIpPrefix

Int32

String

Hashtable

Saídas

PSPublicIpAddress