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.

Syntax

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
Aliases:infa
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Určuje informační proměnnou.

Typ:String
Aliases:iv
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-InstanceDetails

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

Typ:SwitchParameter
Position:3
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters: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
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleName

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

Typ:String
Position:2
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceName

Určuje název služby Azure.

Typ:String
Position:0
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-Slot

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

Typ:String
Position:1
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False