New-AzureRmPublicIpAddress

Referência

Módulo:: AzureRM.Network

Cria um endereço IP público.

Aviso

O módulo AzureRM PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

New-AzureRmPublicIpAddress
   [-Name <String>]
   -ResourceGroupName <String>
   [-Location <String>]
   [-Sku <String>]
   -AllocationMethod <String>
   [-IpAddressVersion <String>]
   [-DomainNameLabel <String>]
   [-IpTag <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag]>]
   [-PublicIpPrefix <Microsoft.Azure.Commands.Network.Models.PSPublicIpPrefix>]
   [-ReverseFqdn <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-Zone <System.Collections.Generic.List`1[System.String]>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

Exemplos

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

$publicIp = New-AzureRmPublicIpAddress -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).

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

$publicIp = New-AzureRmPublicIpAddress -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.

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

$ipTag = New-AzureRmPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTags ipTag

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

$publicIp = New-AzureRmPublicIpAddress -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.

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

-DefaultProfile

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

Tipo:	IAzureContextContainer
Aliases:	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

-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

-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:	List<T>[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:	False
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

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

Entradas

String

List<T>[[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Int32

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Hashtable

Saídas

PSPublicIpAddress

Partilhar via

New-AzureRmPublicIpAddress

Sintaxe

Description

Exemplos

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

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

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

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

Parâmetros

-AllocationMethod

-AsJob

-Confirm

-DefaultProfile

-DomainNameLabel

-Force

-IdleTimeoutInMinutes

-IpAddressVersion

-IpTag

-Location

-Name

-PublicIpPrefix

-ResourceGroupName

-ReverseFqdn

-Sku

-Tag

-WhatIf

-Zone

Entradas

Saídas

Recursos adicionais

Partilhar via

New-AzureRmPublicIpAddress

Sintaxe

Description

Exemplos

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

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

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

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

Parâmetros

-AllocationMethod

-AsJob

-Confirm

-DefaultProfile

-DomainNameLabel

-Force

-IdleTimeoutInMinutes

-IpAddressVersion

-IpTag

-Location

-Name

-PublicIpPrefix

-ResourceGroupName

-ReverseFqdn

-Sku

-Tag

-WhatIf

-Zone

Entradas

Saídas

Ligações Relacionadas

Recursos adicionais