共用方式為


New-AzPublicIpAddress

建立公用 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

此命令會建立新的公用IP位址資源。系統會針對指向此資源的公用IP位址$dnsPrefix.$location.cloudapp.azure.com建立 DNS 記錄。 公用IP位址會立即配置給此資源,因為 -AllocationMethod 會指定為 'Static'。 如果指定為「動態」,則只有在您啟動或建立相關聯的資源時,才會配置公用IP位址(例如 VM 或負載平衡器)。 Iptag 是用來指定與資源相關聯的標記。 您可以使用 New-AzPublicIpTag 來指定 Iptag,並透過 -IpTags 傳遞作為輸入。

範例 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