Compartilhar via


Set-AzPublicIpAddress

Atualiza um endereço IP público.

Sintaxe

Default (Default)

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:PSPublicIpAddress
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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

PSPublicIpAddress

Saídas

PSPublicIpAddress