Freigeben über

Set-AzurePublicIP

  • Referenz
Modul:
Azure

Fügt eine öffentliche IP zu einem virtuellen Azure-Computer hinzu.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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

Beschreibung

Das Cmdlet Set-AzurePublicIP fügt einem virtuellen Azure-Computer eine öffentliche IP hinzu. Wenn Sie dieses Cmdlet für einen vorhandenen virtuellen Computer ausführen, aktualisieren Sie den virtuellen Computer, um Ihre Änderungen zu implementieren. Sie können eine Domänennamenbezeichnung angeben, um einen entsprechenden DNS-Eintrag für die öffentliche IP zu erstellen.

Beispiele

Beispiel 1: Hinzufügen einer öffentlichen IP zu einem vorhandenen virtuellen Computer

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

Dieser Befehl ruft den virtuellen Computer mit dem Namen FTPInstance im Dienst "FTPInAzure" mithilfe des Cmdlets "Get-AzureVM " ab. Der Befehl übergibt diesen virtuellen Computer mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet fügt den ftpip für den öffentlichen IP-Namen hinzu. Der Befehl übergibt den virtuellen Computer an das Update-AzureVM-Cmdlet , das Ihre Änderungen implementiert.

Beispiel 2: Hinzufügen einer öffentlichen IP zu einem neuen virtuellen Computer

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"

Mit diesem Befehl wird ein Konfigurationsobjekt für virtuelle Computer mithilfe des Cmdlets New-AzureVMConfig erstellt. Der Befehl übergibt dieses Objekt an das Add-AzureProvisioningConfig-Cmdlet , das zusätzliche Konfiguration bereitstellt. Das aktuelle Cmdlet fügt den ftpip für den öffentlichen IP-Namen hinzu. Der Befehl übergibt die Konfiguration an das New-AzureVM-Cmdlet , das den virtuellen Computer erstellt.

Beispiel 3: Hinzufügen einer öffentlichen IP und einer Bezeichnung zu einem vorhandenen virtuellen Computer

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

Dieser Befehl ruft den virtuellen Computer mit dem Namen FTPInstance im Dienst "FTPInAzure" mithilfe des Cmdlets "Get-AzureVM " ab. Der Befehl übergibt diesen virtuellen Computer mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet fügt den ftpip für den öffentlichen IP-Namen und den Ip-Namen der Bezeichnung hinzu. Der Befehl aktualisiert den virtuellen Computer, der Ihre Änderungen implementiert.

Beispiel 4: Hinzufügen einer öffentlichen IP und einer Bezeichnung zu einem neuen virtuellen Computer

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"

Dieser Befehl erstellt ein Konfigurationsobjekt für virtuelle Computer und übergibt dieses Objekt dann an Add-AzureProvisioningConfig, das zusätzliche Konfiguration bereitstellt. Das aktuelle Cmdlet fügt den ftpip für den öffentlichen IP-Namen und den Ip-Namen der Bezeichnung hinzu. Der Befehl erstellt den virtuellen Computer.

Parameter

-DomainNameLabel

Gibt den Namen an, der für einen entsprechenden DNS-Eintrag für die öffentliche IP-Adresse verwendet werden soll.

Typ:String
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IdleTimeoutInMinutes

Gibt den TCP-Leerlauf-Timeoutzeitraum in Minuten an.

Typ:Int32
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicIPName

Gibt den öffentlichen IP-Namen an.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VM

Gibt den virtuellen Computer an, dem dieses Cmdlet öffentliche IP hinzufügt.

Typ:IPersistentVM
Aliase:InputObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM