Dela via

Get-AzureRole

  • Referens
Modul:
Azure

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

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.

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 acceptabla värdena för den här parametern är:

  • Fortsätt
  • Ignorera
  • Fråga
  • TystKontinuera
  • Stoppa
  • Suspend
Typ:ActionPreference
Alias:infa
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InformationVariable

Anger en informationsvariabel.

Typ:String
Alias:iv
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InstanceDetails

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

Typ:SwitchParameter
Position:3
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:AzureSMProfile
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RoleName

Anger namnet på rollen som ska hämtas.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ServiceName

Anger namnet på Azure-tjänsten.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Slot

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

Typ:String
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False