Partilhar via

Set-AzurePublicIP

  • Referência
Módulo:
Azure

Adiciona um IP público a uma máquina virtual do Azure.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para gerenciar recursos do Azure Resource Manager.

Syntax

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

Description

O cmdlet Set-AzurePublicIP adiciona um IP público a uma máquina virtual do Azure. Se você executar esse cmdlet para uma máquina virtual existente, atualize a máquina virtual para implementar suas alterações. Você pode especificar um rótulo de nome de domínio para criar uma entrada DNS correspondente para o IP público.

Exemplos

Exemplo 1: Adicionar um IP público a uma máquina virtual existente

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

Este comando obtém a máquina virtual chamada FTPInstance no serviço chamado FTPInAzure usando o cmdlet Get-AzureVM . O comando passa essa máquina virtual para o cmdlet atual usando o operador de pipeline. O cmdlet atual adiciona o nome IP público ftpip. O comando passa a máquina virtual para o cmdlet Update-AzureVM , que implementa suas alterações.

Exemplo 2: Adicionar um IP público a uma nova 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 cria um objeto de configuração de máquina virtual usando o cmdlet New-AzureVMConfig . O comando passa esse objeto para o cmdlet Add-AzureProvisioningConfig , que fornece configuração adicional. O cmdlet atual adiciona o nome IP público ftpip. O comando passa a configuração para o cmdlet New-AzureVM , que cria a máquina virtual.

Exemplo 3: Adicionar um IP público e um rótulo a uma máquina virtual existente

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

Este comando obtém a máquina virtual chamada FTPInstance no serviço chamado FTPInAzure usando o cmdlet Get-AzureVM . O comando passa essa máquina virtual para o cmdlet atual usando o operador de pipeline. O cmdlet atual adiciona o nome IP público ftpip e o rótulo ipname. O comando atualiza a máquina virtual, que implementa suas alterações.

Exemplo 4: Adicionar um IP público e um rótulo a uma nova 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 cria um objeto de configuração de máquina virtual e, em seguida, passa esse objeto para Add-AzureProvisioningConfig, que fornece configuração adicional. O cmdlet atual adiciona o nome IP público ftpip e o rótulo ipname. O comando cria a máquina virtual.

Parâmetros

-DomainNameLabel

Especifica o nome a ser usado para uma entrada DNS correspondente para o endereço IP público.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdleTimeoutInMinutes

Especifica o período de tempo limite de inatividade TCP em minutos.

Type:Int32
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

Especifica como esse cmdlet responde a um evento de informação.

Os valores aceitáveis para este parâmetro são:

  • Continuar
  • Ignorar
  • Informe-se
  • SilenciosamenteContinue
  • Parar
  • Suspender
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Especifica uma variável de informação.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIPName

Especifica o nome IP público.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

Especifica a máquina virtual à qual este cmdlet adiciona IP Público.

Type:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Saídas

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM