Set-AzPublicIpAddress

Met à jour une adresse IP publique.

Syntaxe

Default (Par défaut)

Set-AzPublicIpAddress
    -PublicIpAddress <PSPublicIpAddress>
    [-DdosCustomPolicyId <String>]
    [-RemoveDdosCustomPolicy]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<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 ». Set-AzPublicIPAddress commande met à jour la ressource d’adresse IP publique avec l’objet mis à jour et modifie la méthode d’allocation en « 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. Set-AzPublicIPAddress commande 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. Set-AzPublicIPAddress commande met à jour la ressource d’adresse IP publique avec l’objet mis à jour. DomainNameLabel &Fqdn sont modifiés comme prévu.

Exemple 4 : Associer une stratégie personnalisée DDoS à une adresse IP publique prise en charge

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

Set-AzPublicIpAddress -PublicIpAddress $publicIp -DdosCustomPolicyId $ddosCustomPolicyId

La première commande obtient une adresse IP publique Standard. La deuxième commande associe la stratégie personnalisée DDoS à l’adresse IP publique. Le service vérifie que l’adresse IP publique a une pièce jointe prise en charge, telle qu’une interface réseau.

Exemple 5 : Supprimer une association de stratégie personnalisée DDoS

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

Set-AzPublicIpAddress -PublicIpAddress $publicIp -RemoveDdosCustomPolicy

La première commande obtient l’adresse IP publique. La deuxième commande supprime son association de stratégie personnalisée DDoS.

Paramètres

-AcquirePolicyToken

Acquérir automatiquement un jeton Azure Policy pour cette opération de ressource.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AsJob

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ChangeReference

ID de ressource de référence de modification pour cette opération de ressource.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DdosCustomPolicyId

ID de stratégie personnalisée DDoS à associer à une adresse IP publique prise en charge. Le service vérifie si la pièce jointe d’adresse IP publique prend en charge une stratégie personnalisée DDoS. Ce paramètre ne peut pas être utilisé avec -RemoveDdosCustomPolicy.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PublicIpAddress

Spécifie un objet d’adresse IP publique représentant l’état auquel l’adresse IP publique doit être définie.

Propriétés du paramètre

Type:PSPublicIpAddress
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RemoveDdosCustomPolicy

Supprime l’association de stratégie personnalisée DDoS de l’adresse IP publique. Ce paramètre ne peut pas être utilisé avec -DdosCustomPolicyId.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSPublicIpAddress

Sorties

PSPublicIpAddress