Get-AzureRole

Returnerar en lista över roller i din Microsoft Azure-tjänst.

Kommentar

De cmdletar som refereras i den här dokumentationen är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.

Syntax

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

Description

Cmdleten Get-AzureRole returnerar ett listobjekt med information om rollerna i din Microsoft Azure-tjänst. Om du anger parametern RoleName returnerar Get-AzureRole endast information om den rollen. Om du anger parametern InstanceDetails returneras ytterligare instansspecifik information.

Exempel

Exempel 1: Hämta en lista över roller för en tjänst

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

Det här kommandot returnerar ett objekt med information om alla produktionsroller som körs på MySvc01-tjänsten.

Exempel 2: Hämta information om en roll som körs på en tjänst

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

Det här kommandot returnerar ett objekt med information om rollen MyTestVM3 som körs i mellanlagringsmiljön för Tjänsten MySvc01.

Exempel 3: Hämta instansinformation om instanser av en roll som körs på en tjänst

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

Det här kommandot returnerar ett objekt med information om instanserna av rollen MyTestVM02 som körs i produktionsmiljön på MySvc01-tjänsten.

Exempel 4: Hämta en tabell med rollinstanserna som är associerade med en tjänst

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

Det här kommandot returnerar en tabell med instansnamnet, storleken och statusen för alla rollinstanser som körs i produktionsmiljön i MySvc01-tjänsten.

Parametrar

-InformationAction

Anger hur den här cmdleten svarar på en informationshändelse.

De godtagbara värdena för den här parametern är:

  • Fortsätt
  • Ignorera
  • Fråga
  • TystKontinuera
  • Stoppa
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Anger en informationsvariabel.

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

-InstanceDetails

Anger att den här cmdleten returnerar information om instanserna för varje roll.

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

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

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

-RoleName

Anger namnet på rollen som ska hämtas.

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

-ServiceName

Anger namnet på Azure-tjänsten.

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

-Slot

Anger Azure-distributionsmiljön. De godtagbara värdena för den här parametern är: Produktion eller mellanlagring.

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