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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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:

Fortfahren
Ignorieren
Fragen
SilentlyContinue
Beenden
Angehalten

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

-InformationVariable

Gibt eine Informationsvariable an.

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

-InstanceDetails

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

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

-Profile

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

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

-RoleName

Gibt den Namen der abzurufenden Rolle an.

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

-ServiceName

Gibt den Namen des Azure-Diensts an.

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

-Slot

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

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

Set-AzureRole