Compartilhar via

New-AzPublicIpAddress

  • Referência
Módulo:
Az.Network

Cria um endereço IP público.

Sintaxe

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.

Tipo:String
Valores aceitos:Dynamic, Static
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DdosProtectionMode

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

Tipo:String
Valores aceitos:VirtualNetworkInherited, Enabled, Disabled
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DdosProtectionPlanId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DomainNameLabel

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DomainNameLabelScope

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

Tipo:Nullable<T>[PSDomainNameLabelScopeType]
Valores aceitos:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-EdgeZone

O nome do local estendido.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Force

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IdleTimeoutInMinutes

Especifica o tempo limite ocioso, em minutos.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-IpAddress

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-IpAddressVersion

Especifica a versão do endereço IP.

Tipo:String
Valores aceitos:IPv4, IPv6
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-IpTag

Lista de IpTag.

Tipo:PSPublicIpTag[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Location

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Aliases:ResourceName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PublicIpPrefix

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

Tipo:PSPublicIpPrefix
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroupName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ReverseFqdn

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Sku

O nome do Sku de IP público.

Tipo:String
Valores aceitos:Basic, Standard
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Tag

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

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Tier

A camada de Sku de IP público.

Tipo:String
Valores aceitos:Regional, Global
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Zone

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

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Saídas

PSPublicIpAddress