Get-AzureRole

  • Referenz
Modul:
Azure

Gibt eine Liste der Rollen in Ihrem Microsoft Azure-Dienst zurück.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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

Beschreibung

Das Cmdlet "Get-AzureRole " gibt ein Listenobjekt mit Details zu den Rollen in Ihrem Microsoft Azure-Dienst zurück. Wenn Sie den RoleName-Parameter angeben, gibt Get-AzureRole nur Details zu dieser Rolle zurück. Wenn Sie den Parameter "InstanceDetails " angeben, werden zusätzliche instanzspezifische Details zurückgegeben.

Beispiele

Beispiel 1: Abrufen einer Liste von Rollen für einen Dienst

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production"

Dieser Befehl gibt ein Objekt mit Details zu allen Produktionsrollen zurück, die auf dem MySvc01-Dienst ausgeführt werden.

Beispiel 2: Abrufen von Details zu einer Rolle, die auf einem Dienst ausgeführt wird

PS C:\> Get-AzureRole -ServiceName "MySvc1" -Slot "Staging" -RoleName "MyTestVM3"

Dieser Befehl gibt ein Objekt mit Details zur Rolle "MyTestVM3" zurück, das in der Stagingumgebung des MySvc01-Diensts ausgeführt wird.

Beispiel 3: Abrufen von Instanzinformationen zu Instanzen einer Rolle, die auf einem Dienst ausgeführt wird

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production" -RoleName "MyTestVM02" -InstanceDetails

Dieser Befehl gibt ein Objekt mit Details zu den Instanzen der MyTestVM02-Rolle zurück, die in der Produktionsumgebung für den MySvc01-Dienst ausgeführt wird.

Beispiel 4: Abrufen einer Tabelle der Rolleninstanzen, die einem Dienst zugeordnet sind

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production" -InstanceDetails | Format-Table -Auto "InstanceName", "InstanceSize", "InstanceStatus"

Dieser Befehl gibt eine Tabelle mit dem Namen, der Größe und dem Status aller Rolleninstanzen zurück, die in der Produktionsumgebung im MySvc01-Dienst ausgeführt werden.

Parameter

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstanceDetails

Gibt an, dass dieses Cmdlet Details zu den Instanzen für jede Rolle zurückgibt.

Typ:SwitchParameter
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RoleName

Gibt den Namen der abzurufenden Rolle an.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServiceName

Gibt den Namen des Azure-Diensts an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Slot

Gibt die Azure-Bereitstellungsumgebung an. Die zulässigen Werte für diesen Parameter sind: Produktion oder Staging.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False