Partilhar via

New-AzPublicIpAddress

Módulo:
Az.Network Module

Cria um endereço IP público.

Sintaxe

Default (Predefiniçã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

Este 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 deste recurso. Um endereço IP público é imediatamente atribuído a este recurso, uma vez que 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

Este comando cria um novo recurso de endereço IP público. Com o parâmetro -ReverseFqdn, o Azure cria um registro PTR DNS (pesquisa inversa) para o endereço IP público alocado a esse recurso, apontando para o $customFqdn especificado no comando. Como pré-requisito, o $customFqdn (digamos webapp.contoso.com) deve ter um registro DNS CNAME (pesquisa direta) 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

Este 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 deste recurso. Um endereço IP público é imediatamente atribuído a este recurso, uma vez que 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 Tags associadas ao recurso. Iptag pode ser especificado usando New-AzPublicIpTag e passado como entrada através de -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

Este 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 deste recurso. Um endereço IP público é imediatamente alocado para este recurso a partir do publicIpPrefix especificado. Esta opção só é suportada para o 'Standard' Sku e 'Static' AllocationMethod.

Exemplo 5: Criar um endereço IP público específico a partir de um prefixo BYOIP

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

Este comando cria um novo recurso de endereço IP público com IP específico. NRP verificaria se o IP dado está dentro do PublicIpPrefix e se o PublicIpPrefix dado é BYOIP PublicIpPrefix. o endereço IP público fornecido é imediatamente alocado para este recurso a partir do publicIpPrefix especificado. Esta opção só é suportada para o 'Standard' Sku 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

Este 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 deste recurso. Um endereço IP público global é imediatamente alocado para este recurso. Esta opção só é suportada para o 'Standard' Sku e 'Static' AllocationMethod.

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

Este 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 em hash no FQDN para o endereço IP público alocado a 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 este parâmetro são: Estático ou Dinâmico.

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:Dynamic, Static
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-AsJob

Executar cmdlet em segundo plano

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DdosProtectionMode

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:VirtualNetworkInherited, Enabled, Disabled
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DdosProtectionPlanId

A ID DdosProtectionPlan a anexar ao endereço IP público

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DomainNameLabel

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DomainNameLabelScope

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

Propriedades dos parâmetros

Tipo:

Nullable<T>[PSDomainNameLabelScopeType]

Default value:None
Valores aceites:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-EdgeZone

O nome do local estendido.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Force

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IdleTimeoutInMinutes

Especifica o tempo limite de inatividade, em minutos.

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-IpAddress

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-IpAddressVersion

Especifica a versão do endereço IP.

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:IPv4, IPv6
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-IpTag

Lista IpTag.

Propriedades dos parâmetros

Tipo:

PSPublicIpTag[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Location

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Name

Especifica o nome do endereço IP público criado por esse cmdlet.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Nome do Recurso

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-PublicIpPrefix

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

Propriedades dos parâmetros

Tipo:PSPublicIpPrefix
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ResourceGroupName

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ReverseFqdn

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Sku

O nome público IP Sku.

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:Basic, Standard, StandardV2
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Tag

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

Propriedades dos parâmetros

Tipo:Hashtable
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Tier

A camada de IP Sku pública.

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:Regional, Global
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Zone

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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