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 do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo PowerShell recomendado 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

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.

Tipo:String
Position:3
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IdleTimeoutInMinutes

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

Tipo:Int32
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Tipo:ActionPreference
Aliases:infa
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PublicIPName

Especifica o nome IP público.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VM

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

Tipo:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM