Compartir a través de

Set-AzurePublicIP

  • Referencia
Módulo:
Azure

Agrega una dirección IP pública a una máquina virtual de Azure.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

Set-AzurePublicIP
   [-PublicIPName] <String>
   [[-IdleTimeoutInMinutes] <Int32>]
   [[-DomainNameLabel] <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

El cmdlet Set-AzurePublicIP agrega una dirección IP pública a una máquina virtual de Azure. Si ejecuta este cmdlet para una máquina virtual existente, actualice la máquina virtual para implementar los cambios. Puede especificar una etiqueta de nombre de dominio para crear una entrada DNS correspondiente para la dirección IP pública.

Ejemplos

Ejemplo 1: Adición de una dirección IP pública a una máquina virtual existente

PS C:\> Get-AzureVM -ServiceName "FTPInAzure" -Name "FTPInstance" | Set-AzurePublicIP -PublicIPName "ftpip" | Update-AzureVM

Este comando obtiene la máquina virtual denominada FTPInstance en el servicio denominado FTPInAzure mediante el cmdlet Get-AzureVM . El comando pasa esa máquina virtual al cmdlet actual mediante el operador de canalización. El cmdlet actual agrega el nombre de dirección IP pública ftpip. El comando pasa la máquina virtual al cmdlet Update-AzureVM , que implementa los cambios.

Ejemplo 2: Adición de una dirección IP pública a una nueva máquina virtual

PS C:\> New-AzureVMConfig -Name "FTPInstance" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -AdminUsername "AdminMain" -Password "password" | Set-AzurePublicIP -PublicIPName "ftpip" | New-AzureVM -ServiceName "FTPinAzure" -Location "North Central US"

Este comando crea un objeto de configuración de máquina virtual mediante el cmdlet New-AzureVMConfig . El comando pasa ese objeto al cmdlet Add-AzureProvisioningConfig , que proporciona configuración adicional. El cmdlet actual agrega el nombre de dirección IP pública ftpip. El comando pasa la configuración al cmdlet New-AzureVM , que crea la máquina virtual.

Ejemplo 3: Adición de una dirección IP pública y una etiqueta a una máquina virtual existente

PS C:\> Get-AzureVM -ServiceName "FTPInAzure" -Name "FTPInstance" | Set-AzurePublicIP -PublicIPName "ftpip" -DomainNameLabel "ipname" | Update-AzureVM

Este comando obtiene la máquina virtual denominada FTPInstance en el servicio denominado FTPInAzure mediante el cmdlet Get-AzureVM . El comando pasa esa máquina virtual al cmdlet actual mediante el operador de canalización. El cmdlet actual agrega el nombre de dirección IP pública ftpip y la etiqueta ipname. El comando actualiza la máquina virtual, que implementa los cambios.

Ejemplo 4: Adición de una dirección IP pública y una etiqueta a una nueva máquina virtual

PS C:\> New-AzureVMConfig -Name "FTPInstance" -InstanceSize Small -ImageName $images[50].ImageName | Add-AzureProvisioningConfig -Windows -AdminUsername "AdminMain" -Password "password" | Set-AzurePublicIP -PublicIPName "ftpip" -DomainNameLabel "ipname" | New-AzureVM -ServiceName "FTPinAzure" -Location "North Central US"

Este comando crea un objeto de configuración de máquina virtual y, a continuación, pasa ese objeto a Add-AzureProvisioningConfig, que proporciona configuración adicional. El cmdlet actual agrega el nombre de dirección IP pública ftpip y la etiqueta ipname. El comando crea la máquina virtual.

Parámetros

-DomainNameLabel

Especifica el nombre que se va a usar para una entrada DNS correspondiente para la dirección IP pública.

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IdleTimeoutInMinutes

Especifica el período de tiempo de espera de inactividad de TCP en minutos.

Tipo:Int32
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignore
  • Inquire
  • SilentlyContinue
  • Detención
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PublicIPName

Especifica el nombre de dirección IP pública.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VM

Especifica la máquina virtual a la que este cmdlet agrega la dirección IP pública.

Tipo:IPersistentVM
Alias:InputObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM