New-AzPublicIpAddress

  • Referentie
Module:
Az.Network

Hiermee maakt u een openbaar IP-adres.

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

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
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-AsJob

Cmdlet op de achtergrond uitvoeren

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

-Confirm

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

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

-DdosProtectionMode

De DdosProtectionMode die moet worden gebruikt voor openbaar IP-adres

Type:String
Accepted values:VirtualNetworkInherited, Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DdosProtectionPlanId

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

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

-DefaultProfile

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

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

-DomainNameLabel

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

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

-DomainNameLabelScope

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

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

De naam van de uitgebreide locatie.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdleTimeoutInMinutes

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

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

-IpAddress

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

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

-IpAddressVersion

Hiermee geeft u de versie van het IP-adres.

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

-IpTag

IpTag-lijst.

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

-Location

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

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

-Name

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

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

-PublicIpPrefix

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

Type:PSPublicIpPrefix
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReverseFqdn

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

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

-Sku

De naam van de openbare IP-SKU.

Type:String
Accepted values:Basic, Standard
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tier

De openbare IP-SKU-laag.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Uitvoerwaarden

PSPublicIpAddress