Compartilhar via

Set-AzureRmPublicIpAddress

  • Referência
Módulo:
AzureRM.Network

Define o estado de meta para um endereço IP público.

Aviso

O módulo PowerShell do AzureRM 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 do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Set-AzureRmPublicIpAddress
   -PublicIpAddress <PSPublicIpAddress>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureRmPublicIpAddress define o estado de meta para um endereço IP público.

Exemplos

1: Alterar o método de alocação de um endereço IP público

PS C:\> $publicIp = Get-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

PS C:\> $publicIp.PublicIpAllocationMethod = "Static"
    
PS C:\> Set-AzureRmPublicIpAddress -PublicIpAddress $publicIp

PS C:\> Get-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

O primeiro comando obtém o recurso de endereço IP público com o nome $publicIPName no grupo de recursos $rgName. O segundo comando define o método de alocação do objeto de endereço IP público como "Estático". O comando Set-AzureRmPublicIPAddress atualiza o recurso de endereço IP público com o objeto atualizado e modifica o método de alocação para 'Estático'. Um endereço IP público é alocado imediatamente.

2: Altere o rótulo de domínio DNS de um endereço IP público

PS C:\> $publicIp = Get-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

PS C:\> $publicIp.DnsSettings.DomainNameLabel = "newdnsprefix"
    
PS C:\> Set-AzureRmPublicIpAddress -PublicIpAddress $publicIp

PS C:\> $publicIp = Get-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

O primeiro comando obtém o recurso de endereço IP público com o nome $publicIPName no grupo de recursos $rgName. O segundo comando define a propriedade DomainNameLabel como o prefixo dns necessário. O comando Set-AzureRmPublicIPAddress atualiza o recurso de endereço IP público com o objeto atualizado. DomainNameLabel e Fqdn são modificados conforme o esperado.

Parâmetros

-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

-DefaultProfile

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

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

-PublicIpAddress

Especifica um objeto PublicIpAddress que representa o estado de meta para o qual o endereço IP público deve ser definido.

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

Entradas

PSPublicIpAddress

Parâmetros: PublicIpAddress (ByValue)

Saídas

PSPublicIpAddress