Udostępnij za pośrednictwem

Get-SCJob

  • Odwołanie
Moduł:
VirtualMachineManager

Pobiera obiekty zadań programu VMM.

Składnia

Get-SCJob
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-Full]
   [-Newest <Int32>]
   [-Job <Task>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCJob
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-Full]
   [-All]
   [-Job <Task>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCJob
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-Running]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Opis

Polecenie cmdlet get-SCJob pobiera co najmniej jeden obiekt zadania programu Virtual Machine Manager (VMM) na serwerze programu VMM. Zadanie to seria kroków wykonywanych sekwencyjnie w celu wykonania akcji w środowisku programu VMM. Obiekty zadań można pobrać na podstawie określonych kryteriów.

W programie VMM można grupować szereg zadań i uruchamiać je razem jako zestaw. Na przykład złożona akcja w programie VMM, taka jak tworzenie szablonu, może zawierać szereg zadań nazywanych grupą zadań. Przykłady, które pokazują, jak używać grup zadań, zobacz następujące polecenia cmdlet: New-SCVMTemplate, New-SCHardwareProfile, New-SCVirtualDiskDrive, New-SCVirtualDVDDrive, New-SCVirtualMachine i Set-SCVirtualCOMPort.

Przykłady

Przykład 1. Pobieranie wszystkich uruchomionych zadań

PS C:\> Get-SCJob -Running

To polecenie pobiera wszystkie uruchomione zadania.

Przykład 2. Pobieranie wszystkich zadań, które zakończyły się niepowodzeniem

PS C:\> $VMMJobs = Get-SCJob | where { $_.Status -eq "Failed" } | Format-List -Property Name, ID, Status
PS C:\> $VMMJobs

Pierwsze polecenie pobiera wszystkie obiekty zadania ze stanem Niepowodzenie, a następnie używa operatora potoku do przekazania każdego obiektu do polecenia cmdlet Format-List, które przechowuje nazwę, identyfikator i stan w zmiennej $VMMJobs.

Drugie polecenie wyświetla informacje przechowywane w $VMMJobs dla użytkownika (w tym przypadku jest to nazwa, identyfikator i stan każdego uruchomionego zadania).

Przykład 3. Uzyskiwanie informacji o typie, metodach i właściwościach zadań programu VMM

PS C:\> Get-SCJob | Get-Member

To polecenie używa polecenia cmdlet Get-Member, aby wyświetlić typ, właściwości, metody i zdarzenia dla Get-SCJob.

Parametry

-All

Wskazuje, że to polecenie cmdlet pobiera wszystkie obiekty podrzędne niezależnie od obiektu nadrzędnego. Na przykład polecenie Get-SCVirtualDiskDrive -All pobiera wszystkie obiekty dysków wirtualnych niezależnie od obiektu maszyny wirtualnej lub obiektu szablonu, z którymi jest skojarzony każdy obiekt dysku wirtualnego.

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

-Full

Wskazuje, że polecenie cmdlet zwraca obiekt zadania z rekordem inspekcji.

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

-ID

Określa identyfikator liczbowy jako globalnie unikatowy identyfikator lub identyfikator GUID dla określonego obiektu.

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

-Job

Określa obiekt zadania programu VMM.

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

-Name

Określa nazwę obiektu programu VMM.

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

-Newest

Zwraca wszystkie zadania utworzone w ostatniej określonej liczbie godzin lub zwraca określoną liczbę najnowszych aktualizacji oprogramowania.

Przykładowy format zwracania wszystkich zadań utworzonych w ciągu ostatnich 48 godzin: Get-SCJob -Newest 48

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

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, który określa ten parametr.

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

-OnBehalfOfUserRole

Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole. To polecenie cmdlet działa w imieniu roli użytkownika, którą określa ten parametr.

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

-Running

Wskazuje, że zwracane są wszystkie uruchomione zadania.

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

-VMMServer

Określa obiekt serwera programu VMM.

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

Dane wyjściowe

Job

To polecenie cmdlet zwraca obiekt Job.