Partager via


Set-AzureRmPublicIpAddress

Définit l’état d’objectif d’une adresse IP publique.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

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

Description

L’applet de commande Set-AzureRmPublicIpAddress définit l’état d’objectif d’une adresse IP publique.

Exemples

1 : Modifier la méthode d’allocation d’une adresse IP publique

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

La première commande obtient la ressource d’adresse IP publique avec le nom $publicIPName dans le groupe de ressources $rgName. La deuxième commande définit la méthode d’allocation de l’objet d’adresse IP publique sur « Static ». La commande Set-AzureRmPublicIPAddress met à jour la ressource d’adresse IP publique avec l’objet mis à jour et modifie la méthode d’allocation sur « Static ». Une adresse IP publique est allouée immédiatement.

2 : Modifier l’étiquette de domaine DNS d’une adresse IP publique

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

La première commande obtient la ressource d’adresse IP publique avec le nom $publicIPName dans le groupe de ressources $rgName. La deuxième commande définit la propriété DomainNameLabel sur le préfixe dns requis. La commande Set-AzureRmPublicIPAddress met à jour la ressource d’adresse IP publique avec l’objet mis à jour. DomainNameLabel &Fqdn sont modifiés comme prévu.

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublicIpAddress

Spécifie un objet PublicIpAddress qui représente l’état d’objectif auquel l’adresse IP publique doit être définie.

Type:PSPublicIpAddress
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

PSPublicIpAddress

Paramètres : PublicIpAddress (ByValue)

Sorties

PSPublicIpAddress