Compartilhar via

Set-AzPublicIpAddress

  • Referência
Módulo:
Az.Network

Atualiza um endereço IP público.

Sintaxe

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

Description

O cmdlet Set-AzPublicIpAddress atualiza um endereço IP público.

Exemplos

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

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

$publicIp.PublicIpAllocationMethod = "Static"
    
Set-AzPublicIpAddress -PublicIpAddress $publicIp

Get-AzPublicIpAddress -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". Set-AzPublicIPAddress comando atualiza o recurso de endereço IP público com o objeto atualizado e modifica o método de alocação para 'Static'. Um endereço IP público é alocado imediatamente.

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

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

$publicIp.DnsSettings = @{"DomainNameLabel" = "newdnsprefix"}
    
Set-AzPublicIpAddress -PublicIpAddress $publicIp

$publicIp = Get-AzPublicIpAddress -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. Set-AzPublicIPAddress comando atualiza o recurso de endereço IP público com o objeto atualizado. DomainNameLabel & Fqdn são modificados conforme o esperado.

Exemplo 3: alterar o rótulo de domínio DNS de um endereço IP público

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

$publicIp.DnsSettings.DomainNameLabel = "newdnsprefix"
    
Set-AzPublicIpAddress -PublicIpAddress $publicIp

$publicIp = Get-AzPublicIpAddress -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. Set-AzPublicIPAddress comando atualiza o recurso de endereço IP público com o objeto atualizado. DomainNameLabel & 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:AzContext, 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 de endereço IP público que representa o estado 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

Saídas

PSPublicIpAddress