Set-AzPublicIpAddress

  • Referenz
Modul:
Az.Network

Aktualisiert eine öffentliche IP-Adresse.

Syntax

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

Beschreibung

Das Cmdlet Set-AzPublicIpAddress aktualisiert eine öffentliche IP-Adresse.

Beispiele

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

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

$publicIp.PublicIpAllocationMethod = "Static"
    
Set-AzPublicIpAddress -PublicIpAddress $publicIp

Get-AzPublicIpAddress -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-AzPublicIPAddress" aktualisiert die öffentliche IP-Adressressource mit dem aktualisierten Objekt und ändert die Zuordnungsmethode auf "Static". Eine öffentliche IP-Adresse wird sofort zugewiesen.

Beispiel 2: Hinzufügen einer DNS-Domänenbezeichnung einer öffentlichen IP-Adresse

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

$publicIp.DnsSettings = @{"DomainNameLabel" = "newdnsprefix"}
    
Set-AzPublicIpAddress -PublicIpAddress $publicIp

$publicIp = Get-AzPublicIpAddress -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-AzPublicIPAddress" aktualisiert die öffentliche IP-Adressressource mit dem aktualisierten Objekt. DomainNameLabel & Fqdn werden erwartungsgemäß geändert.

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

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

$publicIp.DnsSettings.DomainNameLabel = "newdnsprefix"
    
Set-AzPublicIpAddress -PublicIpAddress $publicIp

$publicIp = Get-AzPublicIpAddress -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-AzPublicIPAddress" 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:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicIpAddress

Gibt ein öffentliches IP-Adressobjekt an, das den Zustand 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

Ausgaben

PSPublicIpAddress