Set-AzPublicIpAddress
Atualiza um endereço IP público.
Sintaxe
Default (Predefinição)
Set-AzPublicIpAddress
-PublicIpAddress <PSPublicIpAddress>
[-DdosCustomPolicyId <String>]
[-RemoveDdosCustomPolicy]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-AcquirePolicyToken]
[-ChangeReference <String>]
[<CommonParameters>]
Descrição
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 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 "Static". 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 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 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 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 DDoS a um endereço IP público suportado
$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
Set-AzPublicIpAddress -PublicIpAddress $publicIp -DdosCustomPolicyId $ddosCustomPolicyId
O primeiro comando recebe um endereço IP público padrão. 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 suportado, como uma interface de rede.
Exemplo 5: Remover uma associação de políticas personalizadas DDoS
$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
Set-AzPublicIpAddress -PublicIpAddress $publicIp -RemoveDdosCustomPolicy
O primeiro comando recebe o endereço IP público. O segundo comando remove a associação de políticas personalizadas DDoS.
Parâmetros
-AcquirePolicyToken
Adquira automaticamente um token Azure Policy para esta operação de recurso.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-AsJob
Executar cmdlet em segundo plano
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ChangeReference
A alteração do ID de referência do recurso para esta operação de recurso.
Propriedades dos parâmetros
| Tipo: | String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-DdosCustomPolicyId
O ID da política personalizada DDoS para associar a um endereço IP público suportado.
O serviço valida se o endereço IP público em anexo suporta uma política personalizada DDoS.
Este parâmetro não pode ser usado com -RemoveDdosCustomPolicy.
Propriedades dos parâmetros
| Tipo: | String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Propriedades dos parâmetros
| Tipo: | IAzureContextContainer |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 dos parâmetros
| Tipo: | PSPublicIpAddress |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-RemoveDdosCustomPolicy
Remove a associação de políticas personalizadas DDoS do endereço IP Público.
Este parâmetro não pode ser usado com -DdosCustomPolicyId.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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.
