New-AzPublicIpAddress

  • 參考
模組:
Az.Network

建立公用 IP 位址。

Syntax

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。

Type:String
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-AsJob

在背景執行 Cmdlet

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DdosProtectionMode

要用於公用IP位址的 DdosProtectionMode

Type:String
Accepted values:VirtualNetworkInherited, Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DdosProtectionPlanId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainNameLabel

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DomainNameLabelScope

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

Type:Nullable<T>[PSDomainNameLabelScopeType]
Accepted values:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EdgeZone

擴充位置的名稱。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdleTimeoutInMinutes

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IpAddress

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IpAddressVersion

指定IP位址的版本。

Type:String
Accepted values:IPv4, IPv6
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IpTag

IpTag 清單。

Type:PSPublicIpTag[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Aliases:ResourceName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicIpPrefix

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

Type:PSPublicIpPrefix
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReverseFqdn

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Sku

公用IP Sku名稱。

Type:String
Accepted values:Basic, Standard
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

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

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tier

公用IP Sku層。

Type:String
Accepted values:Regional, Global
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

輸入

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

輸出

PSPublicIpAddress