你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-AzureReservedIPAssociation

将保留 IP 地址与现有虚拟机或云服务相关联。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时,建议不要使用旧的 PowerShell 模块,因为计划将停用 ASM。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

Set-AzureReservedIPAssociation
   [-ReservedIPName] <String>
   [-ServiceName] <String>
   [[-VirtualIPName] <String>]
   [[-Slot] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

说明

Set-AzureReservedIPAssociation cmdlet 将保留 IP 地址与正在运行的虚拟机或云服务的虚拟 IP 地址(VIP)相关联。 此 cmdlet 调用时,不得使用保留 IP 地址,并且必须与虚拟机或云服务位于同一区域。

该操作需要大约 30 秒才能完成,之后虚拟机或服务可以使用保留 IP 地址进行访问。

示例

示例 1:设置保留 IP 关联

PS C:\> Set-AzureReservedIPAssociation -ReservedIPName "ResIp14" -ServiceName "PipTestWestEurope"

此命令将名为 ResIp14 的保留 IP 地址分配给服务 PipTestWestEurope。 ResIp14 是西欧区域的保留 IP。

参数

-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

-ReservedIPName

指定要与虚拟机或服务关联的保留 IP 地址的名称。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ServiceName

指定具有要与其关联保留 IP 地址的部署的服务的名称。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Slot

指定部署槽位。 此参数的可接受值为:

  • 临时过程
  • 生产
类型:String
Position:3
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-VirtualIPName

指定要与保留 IP 关联的现有 VIP 的名称。 请参阅 Add-AzureVirtualIP,将 VIP 添加到云服务。

类型:String
Position:2
默认值:None
必需:False
接受管道输入:True
接受通配符:False

输出

Microsoft.WindowsAzure.Commands.Utilities.Common.ManagementOperationContext