Set-AzPublicIpAddress
Actualiza una dirección IP pública.
Sintaxis
Default (valor predeterminado)
Set-AzPublicIpAddress
-PublicIpAddress <PSPublicIpAddress>
[-DdosCustomPolicyId <String>]
[-RemoveDdosCustomPolicy]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-AcquirePolicyToken]
[-ChangeReference <String>]
[<CommonParameters>]
Description
El cmdlet Set-AzPublicIpAddress actualiza una dirección IP pública.
Ejemplos
Ejemplo 1: Cambio del método de asignación de una dirección IP pública
$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
$publicIp.PublicIpAllocationMethod = "Static"
Set-AzPublicIpAddress -PublicIpAddress $publicIp
Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
El primer comando obtiene el recurso de dirección IP pública con el nombre $publicIPName en el grupo de recursos $rgName. El segundo comando establece el método de asignación del objeto de dirección IP pública en "Static". Set-AzPublicIPAddress comando actualiza el recurso de dirección IP pública con el objeto actualizado y modifica el método de asignación a "Static". Una dirección IP pública se asigna inmediatamente.
Ejemplo 2: Agregar etiqueta de dominio DNS de una dirección IP pública
$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
$publicIp.DnsSettings = @{"DomainNameLabel" = "newdnsprefix"}
Set-AzPublicIpAddress -PublicIpAddress $publicIp
$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
El primer comando obtiene el recurso de dirección IP pública con el nombre $publicIPName en el grupo de recursos $rgName. El segundo comando establece la propiedad DomainNameLabel en el prefijo dns necesario. Set-AzPublicIPAddress comando actualiza el recurso de dirección IP pública con el objeto actualizado. DomainNameLabel & Fqdn se modifican según lo previsto.
Ejemplo 3: Cambio de la etiqueta de dominio DNS de una dirección IP pública
$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
$publicIp.DnsSettings.DomainNameLabel = "newdnsprefix"
Set-AzPublicIpAddress -PublicIpAddress $publicIp
$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
El primer comando obtiene el recurso de dirección IP pública con el nombre $publicIPName en el grupo de recursos $rgName. El segundo comando establece la propiedad DomainNameLabel en el prefijo dns necesario. Set-AzPublicIPAddress comando actualiza el recurso de dirección IP pública con el objeto actualizado. DomainNameLabel & Fqdn se modifican según lo previsto.
Ejemplo 4: Asociar una directiva personalizada de DDoS a una dirección IP pública admitida
$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
Set-AzPublicIpAddress -PublicIpAddress $publicIp -DdosCustomPolicyId $ddosCustomPolicyId
El primer comando obtiene una dirección IP pública estándar. El segundo comando asocia la directiva personalizada de DDoS a la dirección IP pública. El servicio valida que la dirección IP pública tiene datos adjuntos admitidos, como una interfaz de red.
Ejemplo 5: Quitar una asociación de directiva personalizada de DDoS
$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
Set-AzPublicIpAddress -PublicIpAddress $publicIp -RemoveDdosCustomPolicy
El primer comando obtiene la dirección IP pública. El segundo comando quita su asociación de directiva personalizada de DDoS.
Parámetros
-AcquirePolicyToken
Adquiera automáticamente un token de Azure Policy para esta operación de recursos.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-AsJob
Ejecución del cmdlet en segundo plano
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ChangeReference
Identificador de recurso de referencia de cambio para esta operación de recurso.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DdosCustomPolicyId
Identificador de directiva personalizada de DDoS que se va a asociar a una dirección IP pública admitida.
El servicio valida si los datos adjuntos de la dirección IP pública admiten una directiva personalizada de DDoS.
Este parámetro no se puede usar con -RemoveDdosCustomPolicy.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Propiedades de parámetro
| Tipo: | IAzureContextContainer |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | AzContext, AzureRmContext, AzureCredential |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PublicIpAddress
Especifica un objeto de dirección IP pública que representa el estado al que se debe establecer la dirección IP pública.
Propiedades de parámetro
| Tipo: | PSPublicIpAddress |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RemoveDdosCustomPolicy
Quita la asociación de directivas personalizadas de DDoS de la dirección IP pública.
Este parámetro no se puede usar con -DdosCustomPolicyId.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
