Set-AzPublicIpAddress
Atualiza um endereço IP público.
Sintaxe
Default (Default)
Set-AzPublicIpAddress
-PublicIpAddress <PSPublicIpAddress>
[-DdosCustomPolicyId <String>]
[-RemoveDdosCustomPolicy]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-AcquirePolicyToken]
[-ChangeReference <String>]
[<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.
Exemplo 4: associar uma política personalizada de DDoS a um endereço IP público com suporte
$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
Set-AzPublicIpAddress -PublicIpAddress $publicIp -DdosCustomPolicyId $ddosCustomPolicyId
O primeiro comando obtém um endereço IP público Standard. O segundo comando associa a política personalizada DDoS ao endereço IP público. O serviço valida que o endereço IP público tem um anexo com suporte, como um adaptador de rede.
Exemplo 5: remover uma associação de política personalizada DDoS
$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
Set-AzPublicIpAddress -PublicIpAddress $publicIp -RemoveDdosCustomPolicy
O primeiro comando obtém o endereço IP público. O segundo comando remove sua associação de política personalizada DDoS.
Parâmetros
-AcquirePolicyToken
Adquira um token de Azure Policy automaticamente para esta operação de recurso.
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 |
-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 |
-ChangeReference
A ID do recurso de referência de alteração para esta operação de recurso.
Propriedades do parâmetro
| Tipo: | String |
| 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 |
-DdosCustomPolicyId
A ID da política personalizada do DDoS a ser associada a um endereço IP público com suporte.
O serviço valida se o anexo de endereço IP público dá suporte a uma política personalizada de DDoS.
Esse parâmetro não pode ser usado com -RemoveDdosCustomPolicy.
Propriedades do parâmetro
| Tipo: | String |
| 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: | True |
| 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 |
-RemoveDdosCustomPolicy
Remove a associação de política personalizada DDoS do endereço IP público.
Esse parâmetro não pode ser usado com -DdosCustomPolicyId.
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: | True |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
