Partager via

Set-AzPublicIpAddress

  • Référence
Module:
Az.Network

Met à jour une adresse IP publique.

Syntaxe

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

Description

L’applet de commande Set-AzPublicIpAddress met à jour une adresse IP publique.

Exemples

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

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

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

Get-AzPublicIpAddress -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-AzPublicIPAddress 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.

Exemple 2 : Ajouter une étiquette de domaine DNS d’une adresse IP publique

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

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

$publicIp = Get-AzPublicIpAddress -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-AzPublicIPAddress met à jour la ressource d’adresse IP publique avec l’objet mis à jour. DomainNameLabel &Fqdn sont modifiés comme prévu.

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

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

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

$publicIp = Get-AzPublicIpAddress -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-AzPublicIPAddress 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:AzContext, 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 d’adresse IP publique représentant l’état 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

Sorties

PSPublicIpAddress