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

Reset-AzureRoleInstance

  • 参考
模块:
Azure

请求重新启动或重置单个角色实例或特定角色的所有角色实例。

注意

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

Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器 （ARM） 资源。

语法

Reset-AzureRoleInstance
     [-ServiceName] <String>
     -Slot <String>
     -InstanceName <String>
     [-Reboot]
     [-Reimage]
     [-Profile <AzureSMProfile>]
     [-InformationAction <ActionPreference>]
     [-InformationVariable <String>]
     [<CommonParameters>]

说明

Reset-AzureRoleInstance cmdlet 请求重新启动或重置部署中运行的角色实例的映像。 此操作同步执行。 重新启动角色实例时，Azure 使实例脱机，重启该实例的基础操作系统，并使该实例重新联机。 写入到本地磁盘的任何数据在重新启动后会保留。 内存中的任何数据都将丢失。

重新映像角色实例会导致不同的行为，具体取决于角色的类型。 对于 Web 角色或辅助角色，当角色重新映像时，Azure 将角色脱机，并将 Azure 来宾操作系统的全新安装写入虚拟机。 然后，角色重新联机。 对于 VM 角色，当角色重新映像时，Azure 将脱机角色，重新应用为其提供的自定义映像，并使该角色重新联机。

重新映像角色时，Azure 会尝试维护任何本地存储资源中的数据;但是，如果暂时性硬件故障，本地存储资源可能会丢失。 如果应用程序要求保留数据，建议写入持久数据源（例如 Azure 驱动器）。 重新映像角色时，写入到本地存储资源定义的本地目录以外的任何数据都将丢失。

示例

示例 1：重启角色实例

PS C:\> ReSet-AzureRoleInstance -ServiceName "MySvc01" -Slot "Staging" -InstanceName "MyWebRole_IN_0" -Reboot

此命令在 MySvc01 服务的过渡部署中重新启动名为 MyWebRole_IN_0 的角色实例。

示例 2：重置角色实例的映像

PS C:\> ReSet-AzureRoleInstance -ServiceName "MySvc01" -Slot "Staging" -Reimage

此命令在 MySvc01 云服务的过渡部署中重新映像角色实例。

示例 3：重置所有角色实例的映像

PS C:\> ReSet-AzureRoleInstance -ServiceName "MySvc1" -Slot "Production" -Reimage

此命令会重新映像 MySvc01 服务生产部署中的所有角色实例。

参数

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为：

  • 继续
  • 忽略
  • 询问
  • SilentlyContinue
  • 停止
  • Suspend
类型:ActionPreference
别名:infa
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InformationVariable

指定信息变量。

类型:String
别名:iv
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InstanceName

指定要重置映像或重新启动的角色实例的名称。

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

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。

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

-Reboot

指定此 cmdlet 重新启动指定的角色实例;如果未指定任何角色实例，则为所有角色实例。 必须包括 Reboot 或 Reimage 参数，但不能同时包含这两个参数。

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

-Reimage

指定此 cmdlet 重新映像指定的角色实例;如果未指定任何角色实例，则为所有角色实例。 必须包括 Reboot 或 Reimage 参数，但不能同时包含这两个参数。

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

-ServiceName

指定服务的名称。

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

-Slot

指定运行角色实例的部署环境。 有效值为：生产和过渡。 可以包括 DeploymentName 或 Slot 参数，但不能同时包含这两个参数。

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