New-AzPublicIpAddress

Modul:
Az.Network Module

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

Syntax

Default (Alapértelmezett) 

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 "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 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 "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 megadható New-AzPublicIpTag használatával, és bemenetként továbbítható az -IpTagsen keresztül.

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 Azure létrehoz egy DNS-rekordot kivonatolt értékkel a teljes tartománynévben az erőforráshoz rendelt nyilvános IP-címhez az $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.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Elfogadott értékek:Dynamic, Static
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-AsJob

Parancsmag futtatása a háttérben

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-DdosProtectionMode

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Elfogadott értékek:VirtualNetworkInherited, Enabled, Disabled
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-DdosProtectionPlanId

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-DefaultProfile

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

Paramétertulajdonságok

Típus:IAzureContextContainer
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:AzContext, AzureRmContext, AzureCredential

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-DomainNameLabel

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-DomainNameLabelScope

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

Paramétertulajdonságok

Típus:

Nullable<T>[PSDomainNameLabelScopeType]

Alapértelmezett érték:None
Elfogadott értékek:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-EdgeZone

A kiterjesztett hely neve.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Force

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

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-IdleTimeoutInMinutes

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

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-IpAddress

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-IpAddressVersion

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Elfogadott értékek:IPv4, IPv6
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-IpTag

IpTag-lista.

Paramétertulajdonságok

Típus:

PSPublicIpTag[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Location

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Name

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:ResourceName

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-PublicIpPrefix

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

Paramétertulajdonságok

Típus:PSPublicIpPrefix
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-ResourceGroupName

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-ReverseFqdn

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Sku

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Elfogadott értékek:Basic, Standard, StandardV2
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Tag

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

Paramétertulajdonságok

Típus:Hashtable
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Tier

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Elfogadott értékek:Regional, Global
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

PSPublicIpTag

PSPublicIpPrefix

Int32

String

Hashtable

Kimenetek

PSPublicIpAddress