Megosztás a következőn keresztül:

New-AzPublicIpAddress

  • Referencia
Modul:
Az.Network

Egy nyilvános IP-címet hoz létre.

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

A New-AzPublicIpAddress parancsmag létrehoz egy nyilvános IP-címet.

Példák

1. példa: Új nyilvános IP-cím létrehozása

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

Ez a parancs létrehoz egy új nyilvános IP-címerőforrást. Létrejön egy DNS-rekord, amely $dnsPrefix.$location.cloudapp.azure.com az erőforrás nyilvános IP-címére mutat. A rendszer azonnal lefoglal egy nyilvános IP-címet ehhez az erőforráshoz, mivel a -AllocationMethod paraméter "Statikusként" van megadva. Ha dinamikusként van megadva, a nyilvános IP-cím csak a társított erőforrás (például virtuális gép vagy terheléselosztó) indításakor (vagy létrehozásakor) lesz lefoglalva.

2. példa: Nyilvános IP-cím létrehozása fordított teljes tartománynévvel

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

Ez a parancs létrehoz egy új nyilvános IP-címerőforrást. A -ReverseFqdn paraméterrel az Azure létrehoz egy DNS PTR-rekordot (fordított keresés) az erőforráshoz lefoglalt nyilvános IP-címhez, amely a parancsban megadott $customFqdn mutat. Előfeltételként a $customFqdn (például webapp.contoso.com) rendelkeznie kell egy DNS CNAME rekorddal (előrekeresés), amely a $dnsPrefix.$location.cloudapp.azure.com mutat.

3. példa: Új nyilvános IP-cím létrehozása ip-címmel

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

Ez a parancs létrehoz egy új nyilvános IP-címerőforrást. Létrejön egy DNS-rekord, amely $dnsPrefix.$location.cloudapp.azure.com az erőforrás nyilvános IP-címére mutat. A rendszer azonnal lefoglal egy nyilvános IP-címet ehhez az erőforráshoz, mivel a -AllocationMethod paraméter "Statikusként" van megadva. Ha dinamikusként van megadva, a nyilvános IP-cím csak a társított erőforrás (például virtuális gép vagy terheléselosztó) indításakor (vagy létrehozásakor) lesz lefoglalva. Az Iptag az erőforráshoz társított címkék pontos megjelölésére szolgál. Az Iptag a New-AzPublicIpTag használatával adható meg, és bemenetként továbbítható az -IpTags használatával.

4. példa: Új nyilvános IP-cím létrehozása előtagból

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

Ez a parancs létrehoz egy új nyilvános IP-címerőforrást. Létrejön egy DNS-rekord, amely $dnsPrefix.$location.cloudapp.azure.com az erőforrás nyilvános IP-címére mutat. A rendszer azonnal lefoglal egy nyilvános IP-címet ehhez az erőforráshoz a megadott publicIpPrefix fájlból. Ez a beállítás csak a "Standard" termékváltozat és a "Static" AllocationMethod esetében támogatott.

5. példa: Adott nyilvános IP-cím létrehozása BYOIP-előtagból

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

Ez a parancs létrehoz egy új nyilvános IP-címerőforrást adott IP-címmel. Az NRP ellenőrzi, hogy a megadott IP-cím a PublicIpPrefixben van-e, és hogy a megadott PublicIpPrefix BYOIP PublicIpPrefix-e. a megadott nyilvános IP-cím azonnal le lesz foglalva ehhez az erőforráshoz a megadott publicIpPrefix fájlból. Ez a beállítás csak a "Standard" termékváltozat, a "Static" AllocationMethod és a BYOIP PublicIpPrefix esetében támogatott.

6. példa: Új globális nyilvános IP-cím létrehozása

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

Ez a parancs létrehoz egy új globális nyilvános IP-címerőforrást. Létrejön egy DNS-rekord, amely $dnsPrefix.$location.cloudapp.azure.com az erőforrás nyilvános IP-címére mutat. A rendszer azonnal lefoglal egy globális nyilvános IP-címet ehhez az erőforráshoz. Ez a beállítás csak a "Standard" termékváltozat és a "Static" AllocationMethod esetében támogatott.

7. példa: Nyilvános IP-cím létrehozása DomainNameLabelScope használatával

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

Ez a parancs létrehoz egy új nyilvános IP-címerőforrást. A -DomainNameLabelScope paraméterrel az Azure létrehoz egy DNS-rekordot kivonatolt értékkel az FQDN-ben az erőforráshoz rendelt nyilvános IP-címhez a $hasedReusePolicy által javasolt szabályzattal.

Paraméterek

-AllocationMethod

Megadja a nyilvános IP-cím lefoglalásának módját. A paraméter elfogadható értékei a következők: Statikus vagy Dinamikus.

Típus:String
Elfogadott értékek:Dynamic, Static
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-AsJob

Parancsmag futtatása a háttérben

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DdosProtectionMode

A nyilvános IP-címhez használandó DdosProtectionMode

Típus:String
Elfogadott értékek:VirtualNetworkInherited, Enabled, Disabled
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-DdosProtectionPlanId

A nyilvános IP-címhez csatolandó DdosProtectionPlan azonosító

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Típus:IAzureContextContainer
Aliasok:AzContext, AzureRmContext, AzureCredential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DomainNameLabel

Egy nyilvános IP-cím relatív DNS-nevét adja meg.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-DomainNameLabelScope

A nyilvános IP-cím DNS-nevének HashedReusePolicy értékét adja meg.

Típus:Nullable<T>[PSDomainNameLabelScopeType]
Elfogadott értékek:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-EdgeZone

A kiterjesztett hely neve.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-IdleTimeoutInMinutes

A tétlen időtúllépést adja meg percekben.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-IpAddress

A BYOIP publicIpAddress létrehozásakor megadja az IP-címet.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-IpAddressVersion

Az IP-cím verzióját adja meg.

Típus:String
Elfogadott értékek:IPv4, IPv6
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-IpTag

IpTag-lista.

Típus:PSPublicIpTag[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Location

Azt a régiót adja meg, amelyben nyilvános IP-címet szeretne létrehozni.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Name

Megadja a parancsmag által létrehozott nyilvános IP-cím nevét.

Típus:String
Aliasok:ResourceName
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-PublicIpPrefix

Azt a PSPublicIpPrefixet adja meg, amelyből a nyilvános IP-címet le szeretné foglalni.

Típus:PSPublicIpPrefix
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ResourceGroupName

Megadja annak az erőforráscsoportnak a nevét, amelyben nyilvános IP-címet szeretne létrehozni.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ReverseFqdn

Egy fordított, teljes tartománynevet (FQDN) ad meg.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Sku

A nyilvános IP-termékváltozat neve.

Típus:String
Elfogadott értékek:Basic, Standard
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Tag

Kulcs-érték párok kivonattábla formájában. Például: @{key0="value0"; key1=$null; key2="value2"}

Típus:Hashtable
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Tier

A nyilvános IP-termékváltozat szintje.

Típus:String
Elfogadott értékek:Regional, Global
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Zone

Az erőforráshoz lefoglalt IP-címet denotáló rendelkezésre állási zónák listájának származnia kell.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

Bevitelek

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Kimenetek

PSPublicIpAddress