Partager via

New-AzPublicIpAddress

  • Référence
Module:
Az.Network

Crée une adresse IP publique.

Syntaxe

New-AzPublicIpAddress
   [-Name <String>]
   -ResourceGroupName <String>
   -Location <String>
   [-EdgeZone <String>]
   [-Sku <String>]
   [-Tier <String>]
   -AllocationMethod <String>
   [-IpAddressVersion <String>]
   [-DomainNameLabel <String>]
   [-DomainNameLabelScope <PSDomainNameLabelScopeType>]
   [-IpTag <PSPublicIpTag[]>]
   [-PublicIpPrefix <PSPublicIpPrefix>]
   [-DdosProtectionMode <String>]
   [-DdosProtectionPlanId <String>]
   [-ReverseFqdn <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-Zone <String[]>]
   [-IpAddress <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande New-AzPublicIpAddress crée une adresse IP publique.

Exemples

Exemple 1 : Créer une adresse IP publique

$publicIp = New-AzPublicIpAddress -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).

Exemple 2 : Créer une adresse IP publique avec un nom de domaine complet inversé

$publicIp = New-AzPublicIpAddress -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.

Exemple 3 : Créer une adresse IP publique avec IpTag

$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $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-AzPublicIpTag et transmis en tant qu’entrée via -IpTags.

Exemple 4 : Créer une adresse IP publique à partir d’un préfixe

$publicIp = New-AzPublicIpAddress -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.

Exemple 5 : Créer une adresse IP publique spécifique à partir d’un préfixe BYOIP

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -Location $location -IpAddress 0.0.0.0 -PublicIpPrefix $publicIpPrefix -Sku Standard

Cette commande crée une ressource d’adresse IP publique avec une adresse IP spécifique. NRP vérifie si l’adresse IP donnée se trouve à l’intérieur de PublicIpPrefix et si publicIpPrefix donné est BYOIP PublicIpPrefix. l’adresse IP publique donnée 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 et BYOIP PublicIpPrefix.

Exemple 6 : Créer une adresse IP publique globale

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $domainNameLabel -Location $location -Sku Standard -Tier Global

Cette commande crée une ressource d’adresse IP publique globale. Un enregistrement DNS est créé pour $dnsPrefix.$location.cloudapp.azure.com pointant vers l’adresse IP publique de cette ressource. Une adresse IP publique globale est immédiatement allouée à cette ressource. Cette option est uniquement prise en charge pour la référence SKU « Standard » et « Static » AllocationMethod.

Exemple 7 : Créer une adresse IP publique avec un DomainNameLabelScope

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $location

Cette commande crée une ressource d’adresse IP publique. Avec le paramètre -DomainNameLabelScope, Azure crée un enregistrement DNS avec une valeur hachée dans le nom de domaine complet pour l’adresse IP publique allouée à cette ressource avec la stratégie suggérée par $hasedReusePolicy.

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

-DdosProtectionMode

DdosProtectionMode à utiliser pour l’adresse IP publique

Type:String
Valeurs acceptées:VirtualNetworkInherited, Enabled, Disabled
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DdosProtectionPlanId

ID DdosProtectionPlan à attacher à l’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

-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

-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

-DomainNameLabelScope

Spécifie le hashedReusePolicy pour le nom DNS d’une adresse IP publique.

Type:Nullable<T>[PSDomainNameLabelScopeType]
Valeurs acceptées:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-EdgeZone

Nom de l’emplacement étendu.

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

-IpAddress

Spécifie l’adresse IP lors de la création d’une adresse IP publique BYOIP.

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

-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: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:True
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

-Tier

Niveau de référence SKU IP public.

Type:String
Valeurs acceptées:Regional, Global
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: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

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Sorties

PSPublicIpAddress