你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzurePublicIP
将公共 IP 添加到 Azure 虚拟机。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。
语法
Set-AzurePublicIP
[-PublicIPName] <String>
[[-IdleTimeoutInMinutes] <Int32>]
[[-DomainNameLabel] <String>]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] 说明
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，该 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 提供其他配置。 当前 cmdlet 添加公共 IP 名称 ftpip。 该命令将配置传递给 New-AzureVM cmdlet，该 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
- 停止
- Suspend
| 类型: | 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