Set-AzurePublicIP
將公用IP新增至 Azure 虛擬機。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。
語法
Set-AzurePublicIP
[-PublicIPName] <String>
[[-IdleTimeoutInMinutes] <Int32>]
[[-DomainNameLabel] <String>]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Description
Set-AzurePublicIP Cmdlet 會將公用IP新增至 Azure 虛擬機。 如果您針對現有的虛擬機執行此 Cmdlet，請更新虛擬機以實作變更。 您可以指定功能變數名稱標籤，為公用IP建立對應的 DNS 專案。
範例
範例 1：將公用 IP 新增至現有的虛擬機
PS C:\> Get-AzureVM -ServiceName "FTPInAzure" -Name "FTPInstance" | Set-AzurePublicIP -PublicIPName "ftpip" | Update-AzureVM此命令會使用 Get-AzureVM Cmdlet，在名為 FTPInAzure 的服務中取得名為 FTPInstance 的虛擬機。 命令會使用管線運算符，將虛擬機傳遞至目前的 Cmdlet。 目前的 Cmdlet 會新增公用 IP 名稱 ftpip。 此命令會將虛擬機傳遞至 Update-AzureVM Cmdlet，以實作您的變更。
範例 2：將公用 IP 新增至新的虛擬機
PS C:\> New-AzureVMConfig -Name "FTPInstance" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -AdminUsername "AdminMain" -Password "password" | Set-AzurePublicIP -PublicIPName "ftpip" | New-AzureVM -ServiceName "FTPinAzure" -Location "North Central US"此命令會使用 New-AzureVMConfig Cmdlet 建立虛擬機組態物件。 命令會將該對象傳遞至 Add-AzureProvisioningConfig Cmdlet，以提供額外的組態。 目前的 Cmdlet 會新增公用 IP 名稱 ftpip。 此命令會將組態傳遞至 New-AzureVM Cmdlet，以建立虛擬機。
範例 3：將公用 IP 和標籤新增至現有的虛擬機
PS C:\> Get-AzureVM -ServiceName "FTPInAzure" -Name "FTPInstance" | Set-AzurePublicIP -PublicIPName "ftpip" -DomainNameLabel "ipname" | Update-AzureVM此命令會使用 Get-AzureVM Cmdlet，在名為 FTPInAzure 的服務中取得名為 FTPInstance 的虛擬機。 命令會使用管線運算符，將虛擬機傳遞至目前的 Cmdlet。 目前的 Cmdlet 會新增公用 IP 名稱 ftpip 和標籤 ipname。 命令會更新虛擬機，以實作您的變更。
範例 4：將公用 IP 和標籤新增至新的虛擬機
PS C:\> New-AzureVMConfig -Name "FTPInstance" -InstanceSize Small -ImageName $images[50].ImageName | Add-AzureProvisioningConfig -Windows -AdminUsername "AdminMain" -Password "password" | Set-AzurePublicIP -PublicIPName "ftpip" -DomainNameLabel "ipname" | New-AzureVM -ServiceName "FTPinAzure" -Location "North Central US"此命令會建立虛擬機組態對象，然後將該對象傳遞至 Add-AzureProvisioningConfig，以提供額外的設定。 目前的 Cmdlet 會新增公用 IP 名稱 ftpip 和標籤 ipname。 命令會建立虛擬機。
參數
-DomainNameLabel
指定要用於公用IP位址之對應 DNS 項目的名稱。
| 類型: | String |
| Position: | 3 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-IdleTimeoutInMinutes
指定以分鐘為單位的 TCP 閑置逾時期間。
| 類型: | Int32 |
| Position: | 2 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InformationAction
指定此 Cmdlet 如何回應資訊事件。
此參數可接受的值為：
- 繼續
- 忽略
- 詢問
- SilentlyContinue
- 停止
- 暫止
| 類型: | ActionPreference |
| 別名: | infa |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InformationVariable
指定資訊變數。
| 類型: | String |
| 別名: | iv |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。
| 類型: | AzureSMProfile |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PublicIPName
指定公用IP名稱。
| 類型: | String |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VM
指定此 Cmdlet 新增公用 IP 的虛擬機。
| 類型: | IPersistentVM |
| 別名: | InputObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
輸出
Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM