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

Get-AzureRole

参考

模块:: Azure

返回 Microsoft Azure 服务中角色的列表。

注意

本文档中引用的 cmdlet 用于管理使用服务管理 API 的旧式 Azure 资源。若要了解用于管理 Azure 资源管理器资源的 cmdlet，请参阅 Az 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
停止
暂停

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

指定信息变量。

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceDetails

指定此 cmdlet 返回有关每个角色的实例的详细信息。

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Profile

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

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RoleName

指定要获取的角色的名称。

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ServiceName

指定 Azure 服务的名称。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Slot

指定 Azure 部署环境。此参数的可接受值为：生产或暂存。

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Set-AzureRole