New-AzPublicIpAddress

Modul:

Az.Network Module

Vytvoří veřejnou IP adresu.

Syntax

Default (Výchozí)

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 -AllocationMethod je určená 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. Při -ReverseFqdn parametru Azure vytvoří záznam DNS PTR (zpětné 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 -AllocationMethod je určená 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.

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	Dynamic, Static
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-AsJob

Spuštění rutiny na pozadí

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DdosProtectionMode

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

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	VirtualNetworkInherited, Enabled, Disabled
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DdosProtectionPlanId

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

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

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DomainNameLabel

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DomainNameLabelScope

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

Vlastnosti parametru

Typ:	Nullable<T>[PSDomainNameLabelScopeType]
Default value:	None
Přípustné hodnoty:	TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-EdgeZone

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Force

Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-IdleTimeoutInMinutes

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

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-IpAddress

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-IpAddressVersion

Určuje verzi IP adresy.

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	IPv4, IPv6
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-IpTag

Seznam iptagů

Vlastnosti parametru

Typ:	PSPublicIpTag[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Location

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Name

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Název zdroje

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-PublicIpPrefix

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

Vlastnosti parametru

Typ:	PSPublicIpPrefix
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ResourceGroupName

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ReverseFqdn

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Sku

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

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	Basic, Standard, StandardV2
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Tag

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

Vlastnosti parametru

Typ:	Hashtable
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Tier

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

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	Regional, Global
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Zone

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

PSPublicIpTag

PSPublicIpPrefix

Int32

String

Hashtable

Výstupy

PSPublicIpAddress

Související odkazy

• Get-AzPublicIpAddress
• Remove-AzPublicIpAddress
• Set-AzPublicIpAddress