New-AzureRmPublicIpAddress
Crée 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
New-AzureRmPublicIpAddress
[-Name <String>]
-ResourceGroupName <String>
[-Location <String>]
[-Sku <String>]
-AllocationMethod <String>
[-IpAddressVersion <String>]
[-DomainNameLabel <String>]
[-IpTag <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag]>]
[-PublicIpPrefix <Microsoft.Azure.Commands.Network.Models.PSPublicIpPrefix>]
[-ReverseFqdn <String>]
[-IdleTimeoutInMinutes <Int32>]
[-Zone <System.Collections.Generic.List`1[System.String]>]
[-Tag <Hashtable>]
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande New-AzureRmPublicIpAddress crée une adresse IP publique.
Exemples
1 : Créer une adresse IP publique
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location
Cette commande crée une ressource d’adresse IP publique. Un enregistrement DNS est créé pour $dnsPrefix.$location.cloudapp.azure.com pointant vers l’adresse IP publique de cette ressource. Une adresse IP publique est immédiatement allouée à cette ressource, car l’allocationMethod est spécifiée comme « Static ». S’il est spécifié comme « Dynamique », une adresse IP publique est allouée uniquement lorsque vous démarrez (ou créez) la ressource associée (par exemple, une machine virtuelle ou un équilibreur de charge).
2 : Créer une adresse IP publique avec un nom de domaine complet inversé
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -ReverseFqdn $customFqdn
Cette commande crée une ressource d’adresse IP publique. Avec le paramètre -ReverseFqdn, Azure crée un enregistrement PTR DNS (recherche inverse) pour l’adresse IP publique allouée à cette ressource, pointant vers la $customFqdn spécifiée dans la commande. En guise de prérequis, le $customFqdn (par exemple, webapp.contoso.com) doit avoir un enregistrement CNAME DNS (recherche vers l’avant) pointant vers $dnsPrefix.$location.cloudapp.azure.com.
3 : Créer une adresse IP publique avec IpTag
$ipTag = New-AzureRmPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTags ipTag
Cette commande crée une ressource d’adresse IP publique. Un enregistrement DNS est créé pour $dnsPrefix.$location.cloudapp.azure.com pointant vers l’adresse IP publique de cette ressource. Une adresse IP publique est immédiatement allouée à cette ressource, car l’allocationMethod est spécifiée comme « Static ». S’il est spécifié comme « Dynamique », une adresse IP publique est allouée uniquement lorsque vous démarrez (ou créez) la ressource associée (par exemple, une machine virtuelle ou un équilibreur de charge). Un iptag est utilisé pour spécifique les balises associées à la ressource. Iptag peut être spécifié à l’aide de New-AzureRmPublicIpTag et transmis en tant qu’entrée via -IpTags.
4 : Créer une adresse IP publique à partir d’un préfixe
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location
-PublicIpPrefix publicIpPrefix -Sku Standard
Cette commande crée une ressource d’adresse IP publique. Un enregistrement DNS est créé pour $dnsPrefix.$location.cloudapp.azure.com pointant vers l’adresse IP publique de cette ressource. Une adresse IP publique est immédiatement allouée à cette ressource à partir du publicIpPrefix spécifié. Cette option est uniquement prise en charge pour la référence SKU « Standard » et « Static » AllocationMethod.
Paramètres
-AllocationMethod
Spécifie la méthode avec laquelle allouer l’adresse IP publique. Les valeurs acceptables pour ce paramètre sont : statique ou dynamique.
Type: | String |
Valeurs acceptées: | Dynamic, Static |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-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 |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Alias: | cf |
Position: | Named |
Valeur par défaut: | False |
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 |
-DomainNameLabel
Spécifie le nom DNS relatif d’une adresse IP publique.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Force
Force l’exécution de la commande sans demander la confirmation de l’utilisateur.
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 |
-IdleTimeoutInMinutes
Spécifie le délai d’inactivité, en minutes.
Type: | Int32 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-IpAddressVersion
Spécifie la version de l’adresse IP.
Type: | String |
Valeurs acceptées: | IPv4, IPv6 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-IpTag
Liste IpTag.
Type: | List<T>[PSPublicIpTag] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Location
Spécifie la région dans laquelle créer une adresse IP publique.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Name
Spécifie le nom de l’adresse IP publique créée par cette applet de commande.
Type: | String |
Alias: | ResourceName |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-PublicIpPrefix
Spécifie le PSPublicIpPrefix à partir duquel allouer l’adresse IP publique.
Type: | PSPublicIpPrefix |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ResourceGroupName
Spécifie le nom du groupe de ressources dans lequel créer une adresse IP publique.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ReverseFqdn
Spécifie un nom de domaine complet inversé (FQDN).
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Sku
Nom de la référence SKU IP publique.
Type: | String |
Valeurs acceptées: | Basic, Standard |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Tag
Paires clé-valeur sous la forme d’une table de hachage. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"}
Type: | Hashtable |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Alias: | wi |
Position: | Named |
Valeur par défaut: | False |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Zone
Liste des zones de disponibilité indiquant l’adresse IP allouée pour la ressource doit provenir.
Type: | List<T>[String] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
Entrées
List<T>[[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]