New-AzPublicIpAddress

Crea un indirizzo IP pubblico.

Sintassi

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>]

Descrizione

Il cmdlet New-AzPublicIpAddress crea un indirizzo IP pubblico.

Esempio

Esempio 1: Creare un nuovo indirizzo IP pubblico

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

Questo comando crea una nuova risorsa indirizzo IP pubblico. Viene creato un record DNS per $dnsPrefix.$location.cloudapp.azure.com che punta all'indirizzo IP pubblico di questa risorsa. Un indirizzo IP pubblico viene immediatamente allocato a questa risorsa perché -AllocationMethod viene specificato come 'Statico'. Se è specificato come "Dinamico", un indirizzo IP pubblico viene allocato solo quando si avvia (o si crea) la risorsa associata (ad esempio una macchina virtuale o un servizio di bilanciamento del carico).

Esempio 2: Creare un indirizzo IP pubblico con un FQDN inverso

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

Questo comando crea una nuova risorsa indirizzo IP pubblico. Con il parametro -ReverseFqdn, Azure crea un record PTR DNS (ricerca inversa) per l'indirizzo IP pubblico allocato a questa risorsa, puntando al $customFqdn specificato nel comando. Come prerequisito, il $customFqdn (ad esempio webapp.contoso.com) deve avere un record CNAME DNS (forward-lookup) che punta a $dnsPrefix.$location.cloudapp.azure.com.

Esempio 3: Creare un nuovo indirizzo IP pubblico con IpTag

$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $ipTag

Questo comando crea una nuova risorsa indirizzo IP pubblico. Viene creato un record DNS per $dnsPrefix.$location.cloudapp.azure.com che punta all'indirizzo IP pubblico di questa risorsa. Un indirizzo IP pubblico viene immediatamente allocato a questa risorsa perché -AllocationMethod viene specificato come 'Statico'. Se è specificato come "Dinamico", un indirizzo IP pubblico viene allocato solo quando si avvia (o si crea) la risorsa associata (ad esempio una macchina virtuale o un servizio di bilanciamento del carico). Un iptag viene usato per specificare i tag associati alla risorsa. È possibile specificare iptag usando New-AzPublicIpTag e passato come input tramite -IpTags.

Esempio 4: Creare un nuovo indirizzo IP pubblico da un prefisso

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

Questo comando crea una nuova risorsa indirizzo IP pubblico. Viene creato un record DNS per $dnsPrefix.$location.cloudapp.azure.com che punta all'indirizzo IP pubblico di questa risorsa. Un indirizzo IP pubblico viene immediatamente allocato a questa risorsa dal publicIpPrefix specificato. Questa opzione è supportata solo per lo SKU 'Standard' e 'Static' AllocationMethod.

Esempio 5: Creare un indirizzo IP pubblico specifico da un prefisso BYOIP

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

Questo comando crea una nuova risorsa indirizzo IP pubblico con un indirizzo IP specifico. NRP verifica se l'indirizzo IP specificato si trova all'interno di PublicIpPrefix e se il valore PublicIpPrefix specificato è BYOIP PublicIpPrefix. l'indirizzo IP pubblico specificato viene allocato immediatamente a questa risorsa dal publicIpPrefix specificato. Questa opzione è supportata solo per lo SKU 'Standard' e 'Static' AllocationMethod e BYOIP PublicIpPrefix.

Esempio 6: Creare un nuovo indirizzo IP pubblico globale

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

Questo comando crea una nuova risorsa indirizzo IP pubblico globale. Viene creato un record DNS per $dnsPrefix.$location.cloudapp.azure.com che punta all'indirizzo IP pubblico di questa risorsa. Un indirizzo IP pubblico globale viene immediatamente allocato a questa risorsa. Questa opzione è supportata solo per lo SKU 'Standard' e 'Static' AllocationMethod.

Esempio 7: Creare un indirizzo IP pubblico con domainNameLabelScope

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

Questo comando crea una nuova risorsa indirizzo IP pubblico. Con il parametro -DomainNameLabelScope, Azure crea un record DNS con un valore hash nel nome di dominio completo per l'indirizzo IP pubblico allocato a questa risorsa con i criteri suggeriti da $hasedReusePolicy.

Parametri

-AllocationMethod

Specifica il metodo con cui allocare l'indirizzo IP pubblico. I valori accettabili per questo parametro sono Statici o Dinamici.

Type:String
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-AsJob

Eseguire il cmdlet in background

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DdosProtectionMode

DdosProtectionMode da usare per l'indirizzo IP pubblico

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 da collegare all'indirizzo IP pubblico

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainNameLabel

Specifica il nome DNS relativo per un indirizzo IP pubblico.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DomainNameLabelScope

Specifica hashedReusePolicy per il nome DNS per un indirizzo IP pubblico.

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

Nome della posizione estesa.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdleTimeoutInMinutes

Specifica il timeout di inattività, espresso in minuti.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IpAddress

Specifica l'indirizzo IP durante la creazione di un indirizzo IP BYOIP publicIpAddress.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IpAddressVersion

Specifica la versione dell'indirizzo IP.

Type:String
Accepted values:IPv4, IPv6
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IpTag

Elenco IpTag.

Type:PSPublicIpTag[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Specifica l'area in cui creare un indirizzo IP pubblico.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifica il nome dell'indirizzo IP pubblico creato da questo cmdlet.

Type:String
Aliases:ResourceName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicIpPrefix

Specifica il PSPublicIpPrefix da cui allocare l'indirizzo IP pubblico.

Type:PSPublicIpPrefix
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Specifica il nome del gruppo di risorse in cui creare un indirizzo IP pubblico.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReverseFqdn

Specifica un nome di dominio completo (FQDN) inverso.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Sku

Nome sku DELL'INDIRIZZO IP pubblico.

Type:String
Accepted values:Basic, Standard
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Coppie chiave-valore sotto forma di tabella hash. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tier

Livello SKU DELL'INDIRIZZO IP pubblico.

Type:String
Accepted values:Regional, Global
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Elenco delle zone di disponibilità che denota l'INDIRIZZO IP allocato per la risorsa da cui deve provenire.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Input

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Output

PSPublicIpAddress