Set-AzurePublicIP
Fügt eine öffentliche IP zu einem virtuellen Azure-Computer hinzu.
Hinweis
Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IdleTimeoutInMinutes
Gibt den TCP-Leerlauf-Timeoutzeitraum in Minuten an.
Typ: | Int32 |
Position: | 2 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationAction
Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.
Zulässige Werte für diesen Parameter:
- Weiter
- Ignorieren
- Inquire
- SilentlyContinue
- Beenden
- Angehalten
Typ: | ActionPreference |
Aliases: | infa |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Gibt eine Informationsvariable an.
Typ: | String |
Aliases: | iv |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicIPName
Gibt den öffentlichen IP-Namen an.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
Gibt den virtuellen Computer an, dem dieses Cmdlet öffentliche IP hinzufügt.
Typ: | IPersistentVM |
Aliases: | InputObject |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Ausgaben
Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM