Sdílet prostřednictvím


New-AzPublicIpAddress

Vytvoří veřejnou IP adresu.

Syntaxe

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

Rutina New-AzPublicIpAddress vytvoří veřejnou IP adresu.

Příklady

Příklad 1: Vytvoření nové veřejné IP adresy

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

Tento příkaz vytvoří nový prostředek veřejné IP adresy. Vytvoří se záznam DNS pro $dnsPrefix.$location.cloudapp.azure.com odkazující na veřejnou IP adresu tohoto prostředku. Veřejné IP adresy se k tomuto prostředku okamžitě přidělí, protože parametr -AllocationMethod je zadaný jako statická. Pokud je zadaná jako dynamická, přidělí se veřejná IP adresa pouze při spuštění (nebo vytvoření) přidruženého prostředku (například virtuálního počítače nebo nástroje pro vyrovnávání zatížení).

Příklad 2: Vytvoření veřejné IP adresy s reverzním plně kvalifikovaným názvem domény

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

Tento příkaz vytvoří nový prostředek veřejné IP adresy. S parametrem -ReverseFqdn vytvoří Azure záznam PTR DNS (reverzní vyhledávání) pro veřejnou IP adresu přidělenou tomuto prostředku, který ukazuje na $customFqdn zadaný v příkazu. Předpokladem je, že $customFqdn (řekněme webapp.contoso.com) by měl obsahovat záznam DNS CNAME (dopředné vyhledávání) odkazující na $dnsPrefix.$location.cloudapp.azure.com.

Příklad 3: Vytvoření nové veřejné IP adresy se značkou IpTag

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

Tento příkaz vytvoří nový prostředek veřejné IP adresy. Vytvoří se záznam DNS pro $dnsPrefix.$location.cloudapp.azure.com odkazující na veřejnou IP adresu tohoto prostředku. Veřejné IP adresy se k tomuto prostředku okamžitě přidělí, protože parametr -AllocationMethod je zadaný jako statická. Pokud je zadaná jako dynamická, přidělí se veřejná IP adresa pouze při spuštění (nebo vytvoření) přidruženého prostředku (například virtuálního počítače nebo nástroje pro vyrovnávání zatížení). Iptag se používá k určení značek přidružených k prostředku. Iptag lze zadat pomocí New-AzPublicIpTag a předat jako vstup prostřednictvím -IpTags.

Příklad 4: Vytvoření nové veřejné IP adresy z předpony

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

Tento příkaz vytvoří nový prostředek veřejné IP adresy. Vytvoří se záznam DNS pro $dnsPrefix.$location.cloudapp.azure.com odkazující na veřejnou IP adresu tohoto prostředku. Veřejná IP adresa se okamžitě přidělí tomuto prostředku ze zadaného publicIpPrefixu. Tato možnost je podporována pouze pro skladovou položku Standard a Static AllocationMethod.

Příklad 5: Vytvoření konkrétní veřejné IP adresy z předpony BYOIP

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

Tento příkaz vytvoří nový prostředek veřejné IP adresy s konkrétní IP adresou. NRP zkontroluje, jestli se daná IP adresa nachází uvnitř publicIpPrefixu a jestli je daná hodnota PublicIpPrefix BYOIP PublicIpPrefix. daná veřejná IP adresa se okamžitě přidělí tomuto prostředku ze zadaného publicIpPrefixu. Tato možnost je podporována pouze pro skladovou položku Standard a StaticKá PřiděleníMethod a BYOIP PublicIpPrefix.

Příklad 6: Vytvoření nové globální veřejné IP adresy

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

Tento příkaz vytvoří nový globální prostředek veřejné IP adresy. Vytvoří se záznam DNS pro $dnsPrefix.$location.cloudapp.azure.com odkazující na veřejnou IP adresu tohoto prostředku. K tomuto prostředku se okamžitě přidělí globální veřejná IP adresa. Tato možnost je podporována pouze pro skladovou položku Standard a Static AllocationMethod.

Příklad 7: Vytvoření veřejné IP adresy pomocí DomainNameLabelScope

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

Tento příkaz vytvoří nový prostředek veřejné IP adresy. S parametrem -DomainNameLabelScope vytvoří Azure záznam DNS s hodnotou hash v plně kvalifikovaném názvu domény pro veřejnou IP adresu přidělenou tomuto prostředku se zásadami navrhovanými $hasedReusePolicy.

Parametry

-AllocationMethod

Určuje metodu, se kterou se má přidělit veřejná IP adresa. Přijatelné hodnoty pro tento parametr jsou: Static nebo Dynamic.

Typ:String
Přípustné hodnoty:Dynamic, Static
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-AsJob

Spuštění rutiny na pozadí

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DdosProtectionMode

DdosProtectionMode, který se má použít pro veřejnou IP adresu

Typ:String
Přípustné hodnoty:VirtualNetworkInherited, Enabled, Disabled
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DdosProtectionPlanId

ID DdosProtectionPlan pro připojení k veřejné IP adrese

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DomainNameLabel

Určuje relativní název DNS pro veřejnou IP adresu.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DomainNameLabelScope

Určuje HashedReusePolicy pro název DNS pro veřejnou IP adresu.

Typ:Nullable<T>[PSDomainNameLabelScopeType]
Přípustné hodnoty:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-EdgeZone

Název rozšířeného umístění.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IdleTimeoutInMinutes

Určuje časový limit nečinnosti v minutách.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-IpAddress

Určuje IP adresu při vytváření BYOIP publicIpAddress.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-IpAddressVersion

Určuje verzi IP adresy.

Typ:String
Přípustné hodnoty:IPv4, IPv6
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-IpTag

Seznam iptagů

Typ:PSPublicIpTag[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Location

Určuje oblast, ve které se má vytvořit veřejná IP adresa.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název veřejné IP adresy, kterou tato rutina vytvoří.

Typ:String
Aliasy:ResourceName
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PublicIpPrefix

Určuje PSPublicIpPrefix, ze kterého se má přidělit veřejná IP adresa.

Typ:PSPublicIpPrefix
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků, ve které se má vytvořit veřejná IP adresa.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ReverseFqdn

Určuje reverzní plně kvalifikovaný název domény (FQDN).

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Sku

Název skladové položky veřejné IP adresy.

Typ:String
Přípustné hodnoty:Basic, Standard
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Tag

Páry klíč-hodnota ve formě tabulky hash. Příklad: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Tier

Úroveň skladové položky veřejné IP adresy.

Typ:String
Přípustné hodnoty:Regional, Global
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Zone

Seznam zón dostupnosti označující IP adresu přidělenou pro prostředek, ze které musí pocházet.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Výstupy

PSPublicIpAddress