Set-AzurePublicIP
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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.
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-AzureVMDieser 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-AzureVMDieser 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.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdleTimeoutInMinutes
Gibt den TCP-Leerlauf-Timeoutzeitraum in Minuten an.
| Type: | Int32 |
| Position: | 2 |
| Default value: | None |
| Required: | 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:
- Fortfahren
- Ignorieren
- Fragen
- SilentlyContinue
- Beenden
- Angehalten
| Type: | ActionPreference |
| Aliases: | infa |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationVariable
Gibt eine Informationsvariable an.
| Type: | String |
| Aliases: | iv |
| Position: | Named |
| Default value: | None |
| Required: | 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.
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublicIPName
Gibt den öffentlichen IP-Namen an.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
Gibt den virtuellen Computer an, dem dieses Cmdlet öffentliche IP hinzufügt.
| Type: | IPersistentVM |
| Aliases: | InputObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Ausgaben
Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM