New-AzPublicIpAddress

Module:

Az.Network Module

Crée une adresse IP publique.

Syntaxe

Default (Par défaut)

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 la -AllocationMethod est spécifiée en tant que « Statique ». 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 DNS PTR (recherche inversée) 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 la -AllocationMethod est spécifiée en tant que « Statique ». 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.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	Dynamic, Static
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
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

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

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

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

-DdosProtectionMode

DdosProtectionMode à utiliser pour l’adresse IP publique

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	VirtualNetworkInherited, Enabled, Disabled
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

-DdosProtectionPlanId

ID DdosProtectionPlan à attacher à l’adresse IP publique

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

-DomainNameLabel

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

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

-DomainNameLabelScope

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

Propriétés du paramètre

Type:	Nullable<T>[PSDomainNameLabelScopeType]
Valeur par défaut:	None
Valeurs acceptées:	TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
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

-EdgeZone

Nom de l’emplacement étendu.

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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-IdleTimeoutInMinutes

Spécifie le délai d’inactivité, en minutes.

Propriétés du paramètre

Type:	Int32
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

-IpAddress

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

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

-IpAddressVersion

Spécifie la version de l’adresse IP.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	IPv4, IPv6
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

-IpTag

Liste IpTag.

Propriétés du paramètre

Type:	PSPublicIpTag[]
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

-Location

Spécifie la région dans laquelle créer une adresse IP publique.

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:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Name

Spécifie le nom de l’adresse IP publique créée par cette applet de commande.

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
Alias:	ResourceName

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

-PublicIpPrefix

Spécifie le PSPublicIpPrefix à partir duquel allouer l’adresse IP publique.

Propriétés du paramètre

Type:	PSPublicIpPrefix
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

-ResourceGroupName

Spécifie le nom du groupe de ressources dans lequel créer une adresse IP publique.

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:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-ReverseFqdn

Spécifie un nom de domaine complet inversé (FQDN).

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

-Sku

Nom de la référence SKU IP publique.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	Basic, Standard, StandardV2
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

-Tag

Paires clé-valeur sous la forme d’une table de hachage. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"}

Propriétés du paramètre

Type:	Hashtable
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

-Tier

Niveau de référence SKU IP public.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	Regional, Global
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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

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

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

-Zone

Liste des zones de disponibilité indiquant l’adresse IP allouée pour la ressource doit provenir.

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

CommonParameters

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

Entrées

String

PSPublicIpTag

PSPublicIpPrefix

Int32

String

Hashtable

Sorties

PSPublicIpAddress

Liens associés

• Get-AzPublicIpAddress
• Remove-AzPublicIpAddress
• Set-AzPublicIpAddress