New-AzPublicIpAddress
Crée une adresse IP publique.
Syntax
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 $locationCette 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 $customFqdnCette 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 $ipTagCette 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 StandardCette 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 StandardCette commande crée une ressource d’adresse IP publique avec une adresse IP spécifique. NRP case activée si l’adresse IP donnée se trouve dans 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 GlobalCette 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 $locationCette 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 |
| Accepted values: | Dynamic, Static |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AsJob
Exécuter l’applet de commande en arrière-plan
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DdosProtectionMode
DdosProtectionMode à utiliser pour l’adresse IP publique
| Type: | String |
| Accepted values: | VirtualNetworkInherited, Enabled, Disabled |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DdosProtectionPlanId
ID DdosProtectionPlan à attacher à l’adresse IP publique
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainNameLabel
Spécifie le nom DNS relatif d’une adresse IP publique.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DomainNameLabelScope
Spécifie le hashedReusePolicy pour le nom DNS d’une adresse IP publique.
| Type: | Nullable<T>[PSDomainNameLabelScopeType] |
| Accepted values: | TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EdgeZone
Nom de l’emplacement étendu.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Force l’exécution de la commande sans demander la confirmation de l’utilisateur.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdleTimeoutInMinutes
Spécifie le délai d’inactivité, en minutes.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IpAddress
Spécifie l’adresse IP lors de la création d’une adresse IP publique BYOIP.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IpAddressVersion
Spécifie la version de l’adresse IP.
| Type: | String |
| Accepted values: | IPv4, IPv6 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IpTag
Liste IpTag.
| Type: | PSPublicIpTag[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Location
Spécifie la région dans laquelle créer une adresse IP publique.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Spécifie le nom de l’adresse IP publique créée par cette applet de commande.
| Type: | String |
| Aliases: | ResourceName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PublicIpPrefix
Spécifie le PSPublicIpPrefix à partir duquel allouer l’adresse IP publique.
| Type: | PSPublicIpPrefix |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
Spécifie le nom du groupe de ressources dans lequel créer une adresse IP publique.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReverseFqdn
Spécifie un nom de domaine complet inversé (FQDN).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Sku
Nom de la référence SKU IP publique.
| Type: | String |
| Accepted values: | Basic, Standard |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tier
Niveau de référence SKU IP public.
| Type: | String |
| Accepted values: | Regional, Global |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Zone
Liste des zones de disponibilité indiquant l’adresse IP allouée pour la ressource doit provenir.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Entrées
String[]
Sorties
Liens associés
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour