Get-AzureRole
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 |