Delen via

Get-AzureRole

  • Referentie
Module:
Azure

Retourneert een lijst met rollen in uw Microsoft Azure-service.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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

Description

De cmdlet Get-AzureRole retourneert een lijstobject met details over de rollen in uw Microsoft Azure-service. Als u de parameter RoleName opgeeft, retourneert Get-AzureRole alleen details over die rol. Als u de parameter InstanceDetails opgeeft, worden aanvullende, exemplaarspecifieke details geretourneerd.

Voorbeelden

Voorbeeld 1: Een lijst met rollen voor een service ophalen

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

Met deze opdracht wordt een object geretourneerd met details over alle productierollen die worden uitgevoerd op de MySvc01-service.

Voorbeeld 2: Details ophalen over een rol die wordt uitgevoerd op een service

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

Met deze opdracht wordt een object geretourneerd met details over de rol MyTestVM3, die wordt uitgevoerd in de faseringsomgeving van de MySvc01-service.

Voorbeeld 3: instantiegegevens ophalen over exemplaren van een rol die wordt uitgevoerd op een service

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

Met deze opdracht wordt een object geretourneerd met details over de exemplaren van de rol MyTestVM02 die wordt uitgevoerd in de productieomgeving op de MySvc01-service.

Voorbeeld 4: Een tabel ophalen van de rolinstanties die zijn gekoppeld aan een service

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

Met deze opdracht wordt een tabel geretourneerd met de naam, grootte en status van alle rolinstanties die worden uitgevoerd in de productieomgeving op de MySvc01-service.

Parameters

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

  • Verdergaan
  • Negeren
  • Vragen
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliassen:infa
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:String
Aliassen:iv
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InstanceDetails

Hiermee geeft u op dat deze cmdlet details retourneert over de exemplaren voor elke rol.

Type:SwitchParameter
Position:3
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RoleName

Hiermee geeft u de naam van de rol die moet worden get.

Type:String
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServiceName

Hiermee geeft u de naam van de Azure-service op.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Slot

Hiermee geeft u de Azure-implementatieomgeving op. De acceptabele waarden voor deze parameter zijn: Productie of Fasering.

Type:String
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False