Compartir a través de


Set-AzPublicIpAddress

Actualiza una dirección IP pública.

Sintaxis

Default (valor predeterminado)

Set-AzPublicIpAddress
    -PublicIpAddress <PSPublicIpAddress>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<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.

Parámetros

-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
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
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
Obligatorio: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
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
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.

Entradas

PSPublicIpAddress

Salidas

PSPublicIpAddress