你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Reset-AzureRoleInstance
请求重新启动或重置单个角色实例或特定角色的所有角色实例。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。
语法
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 |