Udostępnij za pośrednictwem

Get-AzureRole

  • Odwołanie
Moduł:
Azure

Zwraca listę ról w usłudze Microsoft Azure.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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

Opis

Polecenie cmdlet Get-AzureRole zwraca obiekt listy ze szczegółowymi informacjami na temat ról w usłudze Microsoft Azure. Jeśli określisz parametr RoleName , funkcja Get-AzureRole zwraca tylko szczegóły dotyczące tej roli. Jeśli określisz parametr InstanceDetails , zostaną zwrócone dodatkowe szczegóły specyficzne dla wystąpienia.

Przykłady

Przykład 1. Pobieranie listy ról dla usługi

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

To polecenie zwraca obiekt ze szczegółami dotyczącymi wszystkich ról produkcyjnych uruchomionych w usłudze MySvc01.

Przykład 2. Uzyskiwanie szczegółów dotyczących roli uruchomionej w usłudze

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

To polecenie zwraca obiekt ze szczegółowymi informacjami na temat roli MyTestVM3 uruchomionej w środowisku przejściowym usługi MySvc01.

Przykład 3. Pobieranie informacji o wystąpieniu roli uruchomionej w usłudze

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

To polecenie zwraca obiekt ze szczegółami dotyczącymi wystąpień roli MyTestVM02 uruchomionej w środowisku produkcyjnym w usłudze MySvc01.

Przykład 4. Pobieranie tabeli wystąpień ról skojarzonych z usługą

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

To polecenie zwraca tabelę nazwy wystąpienia, rozmiaru i stanu wszystkich wystąpień ról uruchomionych w środowisku produkcyjnym w usłudze MySvc01.

Parametry

-InformationAction

Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.

Dopuszczalne wartości tego parametru to:

  • Kontynuuj
  • Ignoruj
  • Zapytać
  • SilentlyContinue
  • Zatrzymaj
  • Wstrzymanie
Typ:ActionPreference
Aliases:infa
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Określa zmienną informacyjną.

Typ:String
Aliases:iv
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-InstanceDetails

Określa, że to polecenie cmdlet zwraca szczegóły dotyczące wystąpień w każdej roli.

Typ:SwitchParameter
Position:3
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleName

Określa nazwę roli do pobrania.

Typ:String
Position:2
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceName

Określa nazwę usługi platformy Azure.

Typ:String
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-Slot

Określa środowisko wdrażania platformy Azure. Dopuszczalne wartości tego parametru to: Produkcja lub Przemieszczanie.

Typ:String
Position:1
wartość domyślna:None
Wymagane:False
Accept pipeline input:True
Accept wildcard characters:False