Condividi tramite

Set-AzurePublicIP

  • Riferimento
Modulo:
Azure

Aggiunge un indirizzo IP pubblico a una macchina virtuale di Azure.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

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

Descrizione

Il cmdlet Set-AzurePublicIP aggiunge un indirizzo IP pubblico a una macchina virtuale di Azure. Se si esegue questo cmdlet per una macchina virtuale esistente, aggiornare la macchina virtuale per implementare le modifiche. È possibile specificare un'etichetta del nome di dominio per creare una voce DNS corrispondente per l'indirizzo IP pubblico.

Esempio

Esempio 1: Aggiungere un indirizzo IP pubblico a una macchina virtuale esistente

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

Questo comando ottiene la macchina virtuale denominata FTPInstance nel servizio denominato FTPInAzure usando il cmdlet Get-AzureVM . Il comando passa tale macchina virtuale al cmdlet corrente usando l'operatore pipeline. Il cmdlet corrente aggiunge il nome IP pubblico ftpip. Il comando passa la macchina virtuale al cmdlet Update-AzureVM , che implementa le modifiche.

Esempio 2: Aggiungere un indirizzo IP pubblico a una nuova macchina virtuale

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"

Questo comando crea un oggetto di configurazione della macchina virtuale usando il cmdlet New-AzureVMConfig . Il comando passa tale oggetto al cmdlet Add-AzureProvisioningConfig , che fornisce una configurazione aggiuntiva. Il cmdlet corrente aggiunge il nome IP pubblico ftpip. Il comando passa la configurazione al cmdlet New-AzureVM , che crea la macchina virtuale.

Esempio 3: Aggiungere un indirizzo IP pubblico e un'etichetta a una macchina virtuale esistente

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

Questo comando ottiene la macchina virtuale denominata FTPInstance nel servizio denominato FTPInAzure usando il cmdlet Get-AzureVM . Il comando passa tale macchina virtuale al cmdlet corrente usando l'operatore pipeline. Il cmdlet corrente aggiunge il nome IP pubblico ftpip e l'etichetta ipname. Il comando aggiorna la macchina virtuale, che implementa le modifiche.

Esempio 4: Aggiungere un indirizzo IP pubblico e un'etichetta a una nuova macchina virtuale

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"

Questo comando crea un oggetto di configurazione della macchina virtuale e quindi passa tale oggetto a Add-AzureProvisioningConfig, che fornisce una configurazione aggiuntiva. Il cmdlet corrente aggiunge il nome IP pubblico ftpip e l'etichetta ipname. Il comando crea la macchina virtuale.

Parametri

-DomainNameLabel

Specifica il nome da usare per una voce DNS corrispondente per l'indirizzo IP pubblico.

Tipo:String
Posizione:3
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IdleTimeoutInMinutes

Specifica il periodo di timeout di inattività TCP in minuti.

Tipo:Int32
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationAction

Specifica la modalità di risposta di questo cmdlet a un evento informativo.

I valori validi per questo parametro sono:

  • Continua
  • Ignora
  • Inquire
  • SilentlyContinue
  • Arresta
  • Sospendi
Tipo:ActionPreference
Alias:infa
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationVariable

Specifica una variabile di informazioni.

Tipo:String
Alias:iv
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PublicIPName

Specifica il nome ip pubblico.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VM

Specifica la macchina virtuale a cui questo cmdlet aggiunge l'indirizzo IP pubblico.

Tipo:IPersistentVM
Alias:InputObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Output

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM