Compartilhar via

Set-AzurePublicIP

  • Referência
Módulo:
Azure

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

Observação

Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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

Esse 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"

Esse 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

Esse 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"

Esse 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.

Tipo:String
Cargo:3
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IdleTimeoutInMinutes

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

Tipo:Int32
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationAction

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

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

  • Continuar
  • Ignorar
  • Perguntar
  • SilentlyContinue
  • Stop
  • Suspend
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Profile

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

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PublicIPName

Especifica o nome do IP público.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VM

Especifica a máquina virtual à qual esse cmdlet adiciona IP público.

Tipo:IPersistentVM
Aliases:InputObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM