共用方式為


Get-AzureRole

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

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager(ASM) API 的舊版 Azure 資源。 建立新的資源時,不建議使用此舊版 PowerShell 模組,因為 ASM 已排定淘汰。 如需詳細資訊,請參閱 Azure Service Manager 淘汰

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager (ARM) 資源的建議 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
  • 停止
  • 暫止
類型:ActionPreference
Aliases:infa
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

指定資訊變數。

類型:String
Aliases:iv
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-InstanceDetails

指定此 Cmdlet 會傳回每個角色上實例的詳細數據。

類型:SwitchParameter
Position:3
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔,此 Cmdlet 會從本機預設配置檔讀取。

類型:AzureSMProfile
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleName

指定要取得的角色名稱。

類型:String
Position:2
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceName

指定 Azure 服務的名稱。

類型:String
Position:0
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-Slot

指定 Azure 部署環境。 此參數可接受的值為:生產或預備。

類型:String
Position:1
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False