New-AzPublicIpAddress

參考

模組:: Az.Network

建立公用 IP 位址。

語法

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

New-AzPublicIpAddress Cmdlet 會建立公用 IP 位址。

範例

範例 1：建立新的公用 IP 位址

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

此命令會建立新的公用IP位址資源。系統會針對指向此資源的公用IP位址$dnsPrefix.$location.cloudapp.azure.com建立 DNS 記錄。公用IP位址會立即配置給此資源，因為 -AllocationMethod 會指定為 'Static'。如果指定為「動態」，則只有在您啟動或建立相關聯的資源時，才會配置公用IP位址（例如 VM 或負載平衡器）。

範例 2：使用反向 FQDN 建立公用 IP 位址

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

此命令會建立新的公用IP位址資源。使用 -ReverseFqdn 參數，Azure 會為配置給此資源的公用IP位址建立 DNS PTR 記錄（反向查閱），指向命令中指定的$customFqdn。作為必要條件，$customFqdn（例如 webapp.contoso.com）應該有指向$dnsPrefix.$location.cloudapp.azure.com的 DNS CNAME 記錄（正向查閱）。

範例 3：使用 IpTag 建立新的公用 IP 位址

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

範例 4：從前置詞建立新的公用 IP 位址

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

此命令會建立新的公用IP位址資源。系統會針對指向此資源的公用IP位址$dnsPrefix.$location.cloudapp.azure.com建立 DNS 記錄。公用IP位址會立即從指定的publicIpPrefix配置給此資源。只有『Standard』 Sku 和『Static』 AllocationMethod 才支援此選項。

範例 5：從 BYOIP 前綴建立特定的公用 IP 位址

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

此命令會建立具有特定IP的新公用IP位址資源。 NRP 會檢查指定的IP是否位於 PublicIpPrefix 內，以及指定的 PublicIpPrefix 是否為 BYOIP PublicIpPrefix。指定的公用IP位址會立即從指定的publicIpPrefix配置給此資源。只有『Standard』 Sku 和『Static』 AllocationMethod 和 BYOIP PublicIpPrefix 才支援此選項。

範例 6：建立新的全域公用 IP 位址

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

此命令會建立新的全域公用IP位址資源。系統會針對指向此資源的公用IP位址$dnsPrefix.$location.cloudapp.azure.com建立 DNS 記錄。全域公用IP位址會立即配置給此資源。只有『Standard』 Sku 和『Static』 AllocationMethod 才支援此選項。

範例 7：使用 DomainNameLabelScope 建立公用 IP 位址

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

此命令會建立新的公用IP位址資源。使用 -DomainNameLabelScope 參數，Azure 會針對配置給此資源的公用 IP 位址，使用$hasedReusePolicy所建議的原則，在 FQDN 中建立具有哈希值的 DNS 記錄。

參數

-AllocationMethod

指定要配置公用IP位址的方法。此參數可接受的值為：Static 或 Dynamic。

類型:	String
接受的值:	Dynamic, Static
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-AsJob

在背景執行 Cmdlet

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DdosProtectionMode

要用於公用IP位址的 DdosProtectionMode

類型:	String
接受的值:	VirtualNetworkInherited, Enabled, Disabled
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DdosProtectionPlanId

要附加至公用IP位址的 DdosProtectionPlan 識別碼

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DomainNameLabel

指定公用IP位址的相對 DNS 名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DomainNameLabelScope

指定公用IP位址之 DNS 名稱的HashedReusePolicy。

類型:	Nullable<T>[PSDomainNameLabelScopeType]
接受的值:	TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-EdgeZone

擴充位置的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Force

強制命令執行，而不要求使用者確認。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IdleTimeoutInMinutes

指定閑置逾時，以分鐘為單位。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-IpAddress

指定建立 BYOIP publicIpAddress 時的 IP 位址。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-IpAddressVersion

指定IP位址的版本。

類型:	String
接受的值:	IPv4, IPv6
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-IpTag

IpTag 清單。

類型:	PSPublicIpTag[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Location

指定要在其中建立公用IP位址的區域。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

指定此 Cmdlet 所建立的公用 IP 位址名稱。

類型:	String
別名:	ResourceName
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-PublicIpPrefix

指定要從中配置公用IP位址的 PSPublicIpPrefix。

類型:	PSPublicIpPrefix
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ResourceGroupName

指定要在其中建立公用IP位址的資源群組名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ReverseFqdn

指定反向完整功能變數名稱（FQDN）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Sku

公用IP Sku名稱。

類型:	String
接受的值:	Basic, Standard
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Tag

哈希表形式的索引鍵/值組。例如：@{key0=“value0”;key1=$null;key2=“value2”}

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Tier

公用IP Sku層。

類型:	String
接受的值:	Regional, Global
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Zone

可用性區域清單，表示為資源配置的IP必須來自。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

輸入

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

輸出

PSPublicIpAddress

共用方式為

New-AzPublicIpAddress

語法

Description

範例

範例 1：建立新的公用 IP 位址

範例 2：使用反向 FQDN 建立公用 IP 位址

範例 3：使用 IpTag 建立新的公用 IP 位址

範例 4：從前置詞建立新的公用 IP 位址

範例 5：從 BYOIP 前綴建立特定的公用 IP 位址

範例 6：建立新的全域公用 IP 位址

範例 7：使用 DomainNameLabelScope 建立公用 IP 位址

參數

-AllocationMethod

-AsJob

-Confirm

-DdosProtectionMode

-DdosProtectionPlanId

-DefaultProfile

-DomainNameLabel

-DomainNameLabelScope

-EdgeZone

-Force

-IdleTimeoutInMinutes

-IpAddress

-IpAddressVersion

-IpTag

-Location

-Name

-PublicIpPrefix

-ResourceGroupName

-ReverseFqdn

-Sku

-Tag

-Tier

-WhatIf

-Zone

輸入

輸出

其他資源

共用方式為

New-AzPublicIpAddress

語法

Description

範例

範例 1：建立新的公用 IP 位址

範例 2：使用反向 FQDN 建立公用 IP 位址

範例 3：使用 IpTag 建立新的公用 IP 位址

範例 4：從前置詞建立新的公用 IP 位址

範例 5：從 BYOIP 前綴建立特定的公用 IP 位址

範例 6：建立新的全域公用 IP 位址

範例 7：使用 DomainNameLabelScope 建立公用 IP 位址

參數

-AllocationMethod

-AsJob

-Confirm

-DdosProtectionMode

-DdosProtectionPlanId

-DefaultProfile

-DomainNameLabel

-DomainNameLabelScope

-EdgeZone

-Force

-IdleTimeoutInMinutes

-IpAddress

-IpAddressVersion

-IpTag

-Location

-Name

-PublicIpPrefix

-ResourceGroupName

-ReverseFqdn

-Sku

-Tag

-Tier

-WhatIf

-Zone

輸入

輸出

相關連結

其他資源