Condividi tramite

New-AzPublicIpAddress

  • Riferimento
Modulo:
Az.Network

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.

Tipo:String
Valori accettati:Dynamic, Static
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-AsJob

Eseguire il cmdlet in background

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DdosProtectionMode

DdosProtectionMode da usare per l'indirizzo IP pubblico

Tipo:String
Valori accettati:VirtualNetworkInherited, Enabled, Disabled
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DdosProtectionPlanId

Id DdosProtectionPlan da collegare all'indirizzo IP pubblico

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DomainNameLabel

Specifica il nome DNS relativo per un indirizzo IP pubblico.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DomainNameLabelScope

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

Tipo:Nullable<T>[PSDomainNameLabelScopeType]
Valori accettati:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-EdgeZone

Nome della posizione estesa.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Force

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IdleTimeoutInMinutes

Specifica il timeout di inattività, espresso in minuti.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-IpAddress

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-IpAddressVersion

Specifica la versione dell'indirizzo IP.

Tipo:String
Valori accettati:IPv4, IPv6
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-IpTag

Elenco IpTag.

Tipo:PSPublicIpTag[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Location

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

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

Tipo:String
Alias:ResourceName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PublicIpPrefix

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

Tipo:PSPublicIpPrefix
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceGroupName

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ReverseFqdn

Specifica un nome di dominio completo (FQDN) inverso.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Sku

Nome sku DELL'INDIRIZZO IP pubblico.

Tipo:String
Valori accettati:Basic, Standard
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Tag

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

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Tier

Livello SKU DELL'INDIRIZZO IP pubblico.

Tipo:String
Valori accettati:Regional, Global
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Zone

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

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Output

PSPublicIpAddress