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

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 a este recurso, pois o -AllocationMethod é especificado como 'Static'. 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 reversa) 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

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.

Tipo:	String
Valores aceites:	Dynamic, Static
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-AsJob

Executar cmdlet em segundo plano

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Confirm

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

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DdosProtectionMode

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

Tipo:	String
Valores aceites:	VirtualNetworkInherited, Enabled, Disabled
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-DdosProtectionPlanId

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DomainNameLabel

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-DomainNameLabelScope

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

Tipo:	Nullable<T>[PSDomainNameLabelScopeType]
Valores aceites:	TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-EdgeZone

O nome do local estendido.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Force

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-IdleTimeoutInMinutes

Especifica o tempo limite de inatividade, em minutos.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-IpAddress

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-IpAddressVersion

Especifica a versão do endereço IP.

Tipo:	String
Valores aceites:	IPv4, IPv6
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-IpTag

Lista IpTag.

Tipo:	PSPublicIpTag[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Location

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Name

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

Tipo:	String
Aliases:	ResourceName
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-PublicIpPrefix

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

Tipo:	PSPublicIpPrefix
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-ResourceGroupName

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-ReverseFqdn

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Sku

O nome público IP Sku.

Tipo:	String
Valores aceites:	Basic, Standard
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Tag

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

Tipo:	Hashtable
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Tier

A camada de IP Sku pública.

Tipo:	String
Valores aceites:	Regional, Global
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Zone

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

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

Entradas

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Saídas

PSPublicIpAddress

Partilhar via

New-AzPublicIpAddress

Sintaxe

Description

Exemplos

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

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

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

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

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

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

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

Parâmetros

-AllocationMethod

-AsJob

-Confirm

-DdosProtectionMode

-DdosProtectionPlanId

-DefaultProfile

-DomainNameLabel

-DomainNameLabelScope

-EdgeZone

-Force

-IdleTimeoutInMinutes

-IpAddress

-IpAddressVersion

-IpTag

-Location

-Name

-PublicIpPrefix

-ResourceGroupName

-ReverseFqdn

-Sku

-Tag

-Tier

-WhatIf

-Zone

Entradas

Saídas

Recursos adicionais

Partilhar via

New-AzPublicIpAddress

Sintaxe

Description

Exemplos

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

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

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

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

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

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

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

Parâmetros

-AllocationMethod

-AsJob

-Confirm

-DdosProtectionMode

-DdosProtectionPlanId

-DefaultProfile

-DomainNameLabel

-DomainNameLabelScope

-EdgeZone

-Force

-IdleTimeoutInMinutes

-IpAddress

-IpAddressVersion

-IpTag

-Location

-Name

-PublicIpPrefix

-ResourceGroupName

-ReverseFqdn

-Sku

-Tag

-Tier

-WhatIf

-Zone

Entradas

Saídas

Ligações Relacionadas

Recursos adicionais