Set-AzureRmPublicIpAddress

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 weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. 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: Dns-Do ändern Standard Bezeichnung 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 Do Standard NameLabel-Eigenschaft auf das erforderliche Dns-Präfix fest. Der Befehl "Set-AzureRmPublicIPAddress" aktualisiert die öffentliche IP-Adressressource mit dem aktualisierten Objekt. Do Standard NameLabel & Fqdn werden wie erwartet geändert.

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddress

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

Type:PSPublicIpAddress
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

PSPublicIpAddress

Parameter: PublicIpAddress (ByValue)

Ausgaben

PSPublicIpAddress