New-AzPublicIpAddress

Modulo:

Az.Network Module

Crea un indirizzo IP pubblico.

Sintassi

Default (Impostazione predefinita)

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é il -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é il -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.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Valori accettati:	Dynamic, Static
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-AsJob

Eseguire il cmdlet in background

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	cfr

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DdosProtectionMode

DdosProtectionMode da usare per l'indirizzo IP pubblico

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Valori accettati:	VirtualNetworkInherited, Enabled, Disabled
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-DdosProtectionPlanId

Id DdosProtectionPlan da collegare all'indirizzo IP pubblico

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-DefaultProfile

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

Proprietà dei parametri

Tipo:	IAzureContextContainer
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DomainNameLabel

Specifica il nome DNS relativo per un indirizzo IP pubblico.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-DomainNameLabelScope

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

Proprietà dei parametri

Tipo:	Nullable<T>[PSDomainNameLabelScopeType]
Valore predefinito:	None
Valori accettati:	TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-EdgeZone

Nome della posizione estesa.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Force

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

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-IdleTimeoutInMinutes

Specifica il timeout di inattività, espresso in minuti.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-IpAddress

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

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-IpAddressVersion

Specifica la versione dell'indirizzo IP.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Valori accettati:	IPv4, IPv6
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-IpTag

Elenco IpTag.

Proprietà dei parametri

Tipo:	PSPublicIpTag[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Location

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

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Name

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

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	ResourceName

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-PublicIpPrefix

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

Proprietà dei parametri

Tipo:	PSPublicIpPrefix
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-ResourceGroupName

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

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-ReverseFqdn

Specifica un nome di dominio completo (FQDN) inverso.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Sku

Nome sku DELL'INDIRIZZO IP pubblico.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Valori accettati:	Basic, Standard, StandardV2
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Tag

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

Proprietà dei parametri

Tipo:	Hashtable
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Tier

Livello SKU DELL'INDIRIZZO IP pubblico.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Valori accettati:	Regional, Global
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-WhatIf

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

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	Wi

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Zone

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

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

PSPublicIpTag

PSPublicIpPrefix

Int32

String

Hashtable

Output

PSPublicIpAddress

Collegamenti correlati

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