你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Get-AzureRole
返回 Microsoft Azure 服务中的角色列表。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。
语法
Get-AzureRole
[-ServiceName] <String>
[[-Slot] <String>]
[[-RoleName] <String>]
[-InstanceDetails]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] 说明
Get-AzureRole cmdlet 返回一个列表对象，其中包含有关 Microsoft azure 服务中角色的详细信息。 如果指定 RoleName 参数， Get-AzureRole 仅返回该角色的详细信息。 如果指定 InstanceDetails 参数，则返回特定于实例的其他详细信息。
示例
示例 1：获取服务的角色列表
PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production"此命令返回一个对象，其中包含 MySvc01 服务上运行的所有生产角色的详细信息。
示例 2：获取有关服务上运行的角色的详细信息
PS C:\> Get-AzureRole -ServiceName "MySvc1" -Slot "Staging" -RoleName "MyTestVM3"此命令返回一个对象，其中包含 MyTestVM3 角色的详细信息，该角色在 MySvc01 服务的暂存环境中运行。
示例 3：获取有关服务上运行的角色实例的实例信息
PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production" -RoleName "MyTestVM02" -InstanceDetails此命令返回一个对象，其中包含 MySvc01 服务生产环境中运行的 MyTestVM02 角色实例的详细信息。
示例 4：获取与服务关联的角色实例的表
PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production" -InstanceDetails | Format-Table -Auto "InstanceName", "InstanceSize", "InstanceStatus"此命令返回 MySvc01 服务生产环境中运行的所有角色实例的实例名称、大小和状态表。
参数
-InformationAction
指定此 cmdlet 如何响应信息事件。
此参数的可接受值为：
- 继续
- 忽略
- 询问
- SilentlyContinue
- 停止
- Suspend
| 类型: | ActionPreference |
| 别名: | infa |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InformationVariable
指定信息变量。
| 类型: | String |
| 别名: | iv |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InstanceDetails
指定此 cmdlet 返回有关每个角色的实例的详细信息。
| 类型: | SwitchParameter |
| Position: | 3 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
| 类型: | AzureSMProfile |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RoleName
指定要获取的角色的名称。
| 类型: | String |
| Position: | 2 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ServiceName
指定 Azure 服务的名称。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Slot
指定 Azure 部署环境。 此参数的可接受值为：生产或暂存。
| 类型: | String |
| Position: | 1 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |