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.