Get-AzureRole

參考

模組:: Azure

傳回 Microsoft Azure 服務中的角色清單。

注意

本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。如需管理 Azure Resource Manager 資源的 Cmdlet，請參閱 Az PowerShell 模組。

Syntax

Get-AzureRole
   [-ServiceName] <String>
   [[-Slot] <String>]
   [[-RoleName] <String>]
   [-InstanceDetails]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

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