New-AzureRmPublicIpAddress
建立公用 IP 位址。
警告
自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。
語法
New-AzureRmPublicIpAddress
[-Name <String>]
-ResourceGroupName <String>
[-Location <String>]
[-Sku <String>]
-AllocationMethod <String>
[-IpAddressVersion <String>]
[-DomainNameLabel <String>]
[-IpTag <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag]>]
[-PublicIpPrefix <Microsoft.Azure.Commands.Network.Models.PSPublicIpPrefix>]
[-ReverseFqdn <String>]
[-IdleTimeoutInMinutes <Int32>]
[-Zone <System.Collections.Generic.List`1[System.String]>]
[-Tag <Hashtable>]
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
New-AzureRmPublicIpAddress Cmdlet 會建立公用 IP 位址。
範例
1：建立新的公用IP位址
$publicIp = New-AzureRmPublicIpAddress -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-AzureRmPublicIpAddress -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-AzureRmPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTags ipTag此命令會建立新的公用IP位址資源。系統會針對指向此資源的公用IP位址$dnsPrefix.$location.cloudapp.azure.com建立 DNS 記錄。 公用IP位址會立即配置給此資源，因為 -AllocationMethod 會指定為 'Static'。 如果指定為「動態」，則只有在您啟動或建立相關聯的資源時，才會配置公用IP位址（例如 VM 或負載平衡器）。 Iptag 是用來指定與資源相關聯的標記。 您可以使用 New-AzureRmPublicIpTag 來指定 Iptag，並透過 -IpTags 傳遞作為輸入。
4：從前置詞建立新的公用IP位址
$publicIp = New-AzureRmPublicIpAddress -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 才支援此選項。
參數
-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 |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DomainNameLabel
指定公用IP位址的相對 DNS 名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Force
強制命令執行，而不要求使用者確認。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-IdleTimeoutInMinutes
指定閑置逾時，以分鐘為單位。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-IpAddressVersion
指定IP位址的版本。
| 類型: | String |
| 接受的值: | IPv4, IPv6 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-IpTag
IpTag 清單。
| 類型: | List<T>[PSPublicIpTag] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Location
指定要在其中建立公用IP位址的區域。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | 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 |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Zone
可用性區域清單，表示為資源配置的IP必須來自。
| 類型: | List<T>[String] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
輸入
List<T>[[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]