Sdílet prostřednictvím

Get-AzureRole

  • Reference
Modul:
Azure

Vrátí seznam rolí ve službě Microsoft Azure.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Syntaxe

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

Description

Rutina Get-AzureRole vrátí objekt seznamu s podrobnostmi o rolích ve vaší službě Microsoft Azure. Pokud zadáte parametr RoleName , vrátí Get-AzureRole pouze podrobnosti o této roli. Pokud zadáte parametr InstanceDetails , vrátí se další podrobnosti specifické pro instanci.

Příklady

Příklad 1: Získání seznamu rolí pro službu

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

Tento příkaz vrátí objekt s podrobnostmi o všech produkčních rolích spuštěných ve službě MySvc01.

Příklad 2: Získání podrobností o roli spuštěné ve službě

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

Tento příkaz vrátí objekt s podrobnostmi o roli MyTestVM3 spuštěný v přípravném prostředí služby MySvc01.

Příklad 3: Získání informací o instancích role spuštěné ve službě

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

Tento příkaz vrátí objekt s podrobnostmi o instancích role MyTestVM02 spuštěné v produkčním prostředí ve službě MySvc01.

Příklad 4: Získání tabulky instancí rolí přidružených ke službě

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

Tento příkaz vrátí tabulku názvu instance, velikosti a stavu všech instancí rolí spuštěných v produkčním prostředí ve službě MySvc01.

Parametry

-InformationAction

Určuje, jak tato rutina reaguje na informační událost.

Tento parametr přijímá tyto hodnoty:

  • Pokračovat
  • Ignorovat
  • Informovat se
  • SilentlyContinue
  • Zastavit
  • Suspend
Typ:ActionPreference
Aliasy:infa
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InformationVariable

Určuje informační proměnnou.

Typ:String
Aliasy:iv
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InstanceDetails

Určuje, že tato rutina vrací podrobnosti o instancích jednotlivých rolí.

Typ:SwitchParameter
Position:3
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:AzureSMProfile
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RoleName

Určuje název role, která se má získat.

Typ:String
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ServiceName

Určuje název služby Azure.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Slot

Určuje prostředí nasazení Azure. Přijatelné hodnoty pro tento parametr jsou: Production nebo Staging.

Typ:String
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False