Freigeben über

Set-AzureRmPublicIpAddress

  • Referenz
Modul:
AzureRM.Network

Legt den Zielstatus für eine öffentliche IP-Adresse fest.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Set-AzureRmPublicIpAddress
   -PublicIpAddress <PSPublicIpAddress>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureRmPublicIpAddress legt den Zielzustand für eine öffentliche IP-Adresse fest.

Beispiele

1: Ändern der Zuordnungsmethode einer öffentlichen IP-Adresse

PS C:\> $publicIp = Get-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

PS C:\> $publicIp.PublicIpAllocationMethod = "Static"
    
PS C:\> Set-AzureRmPublicIpAddress -PublicIpAddress $publicIp

PS C:\> Get-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

Der erste Befehl ruft die öffentliche IP-Adressressource mit dem Namen $publicIPName in der Ressourcengruppe $rgName ab. Der zweite Befehl legt die Zuordnungsmethode des öffentlichen IP-Adressobjekts auf "Static" fest. Der Befehl "Set-AzureRmPublicIPAddress" aktualisiert die öffentliche IP-Adressressource mit dem aktualisierten Objekt und ändert die Zuordnungsmethode in "Static". Eine öffentliche IP-Adresse wird sofort zugewiesen.

2: Ändern der DNS-Domänenbezeichnung einer öffentlichen IP-Adresse

PS C:\> $publicIp = Get-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

PS C:\> $publicIp.DnsSettings.DomainNameLabel = "newdnsprefix"
    
PS C:\> Set-AzureRmPublicIpAddress -PublicIpAddress $publicIp

PS C:\> $publicIp = Get-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

Der erste Befehl ruft die öffentliche IP-Adressressource mit dem Namen $publicIPName in der Ressourcengruppe $rgName ab. Der zweite Befehl legt die DomainNameLabel-Eigenschaft auf das erforderliche DNS-Präfix fest. Der Befehl "Set-AzureRmPublicIPAddress" aktualisiert die öffentliche IP-Adressressource mit dem aktualisierten Objekt. DomainNameLabel & Fqdn werden erwartungsgemäß geändert.

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicIpAddress

Gibt ein PublicIpAddress -Objekt an, das den Zielzustand darstellt, auf den die öffentliche IP-Adresse festgelegt werden soll.

Typ:PSPublicIpAddress
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

PSPublicIpAddress

Parameter: PublicIpAddress (ByValue)

Ausgaben

PSPublicIpAddress