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
Aliasy:infa
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InformationVariable

Określa zmienną informacyjną.

Typ:String
Aliasy:iv
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InstanceDetails

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

Typ:SwitchParameter
Position:3
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RoleName

Określa nazwę roli do pobrania.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ServiceName

Określa nazwę usługi platformy Azure.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Slot

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

Typ:String
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False