Delen via

New-AzPublicIpAddress

  • Referentie
Module:
Az.Network

Hiermee maakt u een openbaar IP-adres.

Syntaxis

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

De cmdlet New-AzPublicIpAddress maakt een openbaar IP-adres.

Voorbeelden

Voorbeeld 1: Een nieuw openbaar IP-adres maken

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

Met deze opdracht maakt u een nieuwe openbare IP-adresresource. Er wordt een DNS-record gemaakt voor $dnsPrefix.$location.cloudapp.azure.com die verwijst naar het openbare IP-adres van deze resource. Er wordt onmiddellijk een openbaar IP-adres aan deze resource toegewezen omdat -AllocationMethod is opgegeven als 'Statisch'. Als dit is opgegeven als Dynamisch, wordt een openbaar IP-adres alleen toegewezen wanneer u de bijbehorende resource start (of maakt), zoals een VM of load balancer.

Voorbeeld 2: Een openbaar IP-adres maken met een omgekeerde FQDN

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

Met deze opdracht maakt u een nieuwe openbare IP-adresresource. Met de parameter -ReverseFqdn maakt Azure een DNS PTR-record (reverse lookup) voor het openbare IP-adres dat aan deze resource is toegewezen, waarbij naar de $customFqdn verwijst die is opgegeven in de opdracht. Als vereiste moet de $customFqdn (bijvoorbeeld webapp.contoso.com) een DNS CNAME-record (forward lookup) hebben die verwijst naar $dnsPrefix.$location.cloudapp.azure.com.

Voorbeeld 3: Een nieuw openbaar IP-adres maken met IpTag

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

Met deze opdracht maakt u een nieuwe openbare IP-adresresource. Er wordt een DNS-record gemaakt voor $dnsPrefix.$location.cloudapp.azure.com die verwijst naar het openbare IP-adres van deze resource. Er wordt onmiddellijk een openbaar IP-adres aan deze resource toegewezen omdat -AllocationMethod is opgegeven als 'Statisch'. Als dit is opgegeven als Dynamisch, wordt een openbaar IP-adres alleen toegewezen wanneer u de bijbehorende resource start (of maakt), zoals een VM of load balancer. Een Iptag wordt gebruikt voor het specificeren van de tags die aan de resource zijn gekoppeld. Iptag kan worden opgegeven met behulp van New-AzPublicIpTag en doorgegeven als invoer via -IpTags.

Voorbeeld 4: Een nieuw openbaar IP-adres maken op basis van een voorvoegsel

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

Met deze opdracht maakt u een nieuwe openbare IP-adresresource. Er wordt een DNS-record gemaakt voor $dnsPrefix.$location.cloudapp.azure.com die verwijst naar het openbare IP-adres van deze resource. Er wordt direct een openbaar IP-adres aan deze resource toegewezen vanuit het opgegeven publicIpPrefix. Deze optie wordt alleen ondersteund voor de 'Standard' SKU en 'Static' AllocationMethod.

Voorbeeld 5: Een specifiek openbaar IP-adres maken op basis van een BYOIP-voorvoegsel

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

Met deze opdracht maakt u een nieuwe openbare IP-adresresource met een specifiek IP-adres. NRP controleert of het opgegeven IP-adres zich in het PublicIpPrefix bevindt en of het opgegeven PublicIpPrefix BYOIP PublicIpPrefix is. het opgegeven openbare IP-adres wordt onmiddellijk toegewezen aan deze resource vanuit het opgegeven publicIpPrefix. Deze optie wordt alleen ondersteund voor de 'Standard' SKU en 'Static' AllocationMethod en BYOIP PublicIpPrefix.

Voorbeeld 6: Een nieuw algemeen openbaar IP-adres maken

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

Met deze opdracht maakt u een nieuwe algemene openbare IP-adresresource. Er wordt een DNS-record gemaakt voor $dnsPrefix.$location.cloudapp.azure.com die verwijst naar het openbare IP-adres van deze resource. Er wordt onmiddellijk een algemeen openbaar IP-adres toegewezen aan deze resource. Deze optie wordt alleen ondersteund voor de 'Standard' SKU en 'Static' AllocationMethod.

Voorbeeld 7: Een openbaar IP-adres maken met een DomainNameLabelScope

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

Met deze opdracht maakt u een nieuwe openbare IP-adresresource. Met de parameter -DomainNameLabelScope maakt Azure een DNS-record met een hashwaarde in FQDN voor het openbare IP-adres dat aan deze resource is toegewezen, met het beleid dat door $hasedReusePolicy wordt voorgesteld.

Parameters

-AllocationMethod

Hiermee geeft u de methode waarmee het openbare IP-adres moet worden toegewezen. De acceptabele waarden voor deze parameter zijn: Statisch of Dynamisch.

Type:String
Geaccepteerde waarden:Dynamic, Static
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DdosProtectionMode

De DdosProtectionMode die moet worden gebruikt voor openbaar IP-adres

Type:String
Geaccepteerde waarden:VirtualNetworkInherited, Enabled, Disabled
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DdosProtectionPlanId

De DdosProtectionPlan-id die moet worden gekoppeld aan het openbare IP-adres

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DomainNameLabel

Hiermee geeft u de relatieve DNS-naam voor een openbaar IP-adres.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DomainNameLabelScope

Hiermee geeft u de HashedReusePolicy voor DNS-naam voor een openbaar IP-adres.

Type:Nullable<T>[PSDomainNameLabelScopeType]
Geaccepteerde waarden:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-EdgeZone

De naam van de uitgebreide locatie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IdleTimeoutInMinutes

Hiermee geeft u de time-out voor inactiviteit, in minuten.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-IpAddress

Hiermee geeft u het IP-adres bij het maken van een BYOIP publicIpAddress.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-IpAddressVersion

Hiermee geeft u de versie van het IP-adres.

Type:String
Geaccepteerde waarden:IPv4, IPv6
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-IpTag

IpTag-lijst.

Type:PSPublicIpTag[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Location

Hiermee geeft u de regio op waarin een openbaar IP-adres moet worden gemaakt.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van het openbare IP-adres dat door deze cmdlet wordt gemaakt.

Type:String
Aliassen:ResourceName
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PublicIpPrefix

Hiermee geeft u het PSPublicIpPrefix waaruit het openbare IP-adres moet worden toegewezen.

Type:PSPublicIpPrefix
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam op van de resourcegroep waarin een openbaar IP-adres moet worden gemaakt.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ReverseFqdn

Hiermee geeft u een omgekeerde fully qualified domain name (FQDN).

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Sku

De naam van de openbare IP-SKU.

Type:String
Geaccepteerde waarden:Basic, Standard
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Bijvoorbeeld: @{key0="value0"; key1=$null; key2="value2"}

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Tier

De openbare IP-SKU-laag.

Type:String
Geaccepteerde waarden:Regional, Global
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Zone

Een lijst met beschikbaarheidszones die het IP-adres aangeeft dat voor de resource is toegewezen, moet afkomstig zijn van.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Uitvoerwaarden

PSPublicIpAddress