Get-ScheduledJobOption

  • Odwołanie
Moduł:
PSScheduledJob

Pobiera opcje zadań zaplanowanych.

Składnia

Get-ScheduledJobOption
   [-InputObject] <ScheduledJobDefinition>
   [<CommonParameters>]
Get-ScheduledJobOption
   [-Id] <Int32>
   [<CommonParameters>]
Get-ScheduledJobOption
   [-Name] <String>
   [<CommonParameters>]

Opis

Polecenie Get-ScheduledJobOption cmdlet pobiera opcje zadań zaplanowanych. To polecenie służy do sprawdzania opcji zadania lub potoku opcji zadania do innych poleceń cmdlet.

Opcje zadania nie są zapisywane na dysku niezależnie; są częścią zaplanowanego zadania. Aby uzyskać opcje zadania zaplanowanego zadania, określ zaplanowane zadanie.

Użyj parametrów Get-ScheduledJobOption polecenia cmdlet, aby zidentyfikować zaplanowane zadanie. Zaplanowane zadania można zidentyfikować według ich nazw lub numerów identyfikacyjnych albo wprowadzając lub potokując obiekty ScheduledJob , takie jak te, które są zwracane przez Get-ScheduledJob polecenie cmdlet, do Get-ScheduledJobOption.

Get-ScheduledJobOption jest jedną z kolekcji poleceń cmdlet planowania zadań w module PSScheduledJob, który znajduje się w programie Windows PowerShell.

Aby uzyskać więcej informacji na temat zaplanowanych zadań, zobacz temat Informacje w module PSScheduledJob. Zaimportuj moduł PSScheduledJob, a następnie wpisz: Get-Help about_Scheduled* lub zobacz about_Scheduled_Jobs.

To polecenie cmdlet zostało wprowadzone w programie Windows PowerShell 3.0.

Przykłady

Przykład 1. Pobieranie opcji zadania

W tym przykładzie są dostępne opcje zadań zaplanowanych odpowiadających określonej nazwie.

Get-ScheduledJobOption -Name "*Backup*"

Przykład 2. Pobieranie wszystkich opcji zadań

W tym przykładzie są dostępne opcje zadań wszystkich zaplanowanych zadań na komputerze lokalnym.

Get-ScheduledJob | Get-ScheduledJobOption

W przykładzie Get-ScheduledJob użyto polecenia cmdlet w celu pobrania zaplanowanych zadań na komputerze lokalnym. Operator potoku (|) wysyła zaplanowane zadania do Get-ScheduledJobOption polecenia cmdlet, które pobiera opcje zadania dla każdego zaplanowanego zadania.

Przykład 3. Pobieranie wybranych opcji zadania

W tym przykładzie pokazano, jak znaleźć obiekt opcji zadań z określonymi wartościami.

Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun}

Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun} |
    ForEach-Object {$_.JobDefinition}

Pierwsze polecenie pobiera opcje zadania, w których właściwość RunElevated ma wartość $True, a właściwość RunWithoutNetwork ma wartość $false. Dane wyjściowe zawierają wybrany obiekt JobOptions .

Drugie polecenie pokazuje, jak znaleźć zaplanowane zadanie, do którego należą opcje zadania. To polecenie używa operatora potoku (|) do wysyłania wybranych opcji zadania do ForEach-Object polecenia cmdlet, które pobiera właściwość JobDefinition każdego obiektu opcji. Właściwość JobDefinition zawiera obiekt zadania źródłowego.

Przykład 4. Tworzenie nowego zadania przy użyciu opcji zadania

W tym przykładzie pokazano, jak używać opcji zadań, które Get-ScheduledJobOption są dostępne w nowym zaplanowanym zadaniu.

$Opts = Get-ScheduledJobOption -Name "BackupTestLogs"
Register-ScheduledJob -Name "Archive-Scripts" -FilePath "\\Srv01\Scripts\ArchiveScripts.ps1" -ScheduledJobOption $Opts

Pierwsze polecenie używa Get-ScheduledJobOption polecenia w celu pobrania opcji zadań zaplanowanego zadania BackupTestLogs. Polecenie zapisuje opcje w zmiennej $Opts .

Drugie polecenie używa Register-ScheduledJob polecenia cmdlet do utworzenia nowego zaplanowanego zadania. Wartość parametru ScheduledJobOption to obiekt options w zmiennej $Opts .

Przykład 5. Pobieranie opcji zadania z komputera zdalnego

$O = Invoke-Command -ComputerName "Srv01" -ScriptBlock {Get-ScheduledJob -Name "DataDemon" }

To polecenie używa Invoke-Command polecenia cmdlet do pobrania opcji zaplanowanego zadania zadania DataDemon na komputerze Srv01. Polecenie zapisuje opcje w zmiennej $O .

Parametry

-Id

Określa numer identyfikacyjny zaplanowanego zadania. Get-ScheduledJobOption pobiera opcje zadania określonego zaplanowanego zadania.

Aby uzyskać numery identyfikacyjne zaplanowanych zadań na komputerze lokalnym lub komputerze zdalnym, użyj Get-ScheduledJob polecenia cmdlet .

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Określa zaplanowane zadanie. Wprowadź zmienną zawierającą obiekt ScheduledJob lub wpisz polecenie lub wyrażenie, które pobiera obiekt ScheduledJob, na przykład Get-ScheduledJob polecenie. Możesz również przekazać obiekt ScheduledJob do Get-ScheduledJobOptionobiektu .

Type:ScheduledJobDefinition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Określa nazwy zaplanowanych zadań. Get-ScheduledJobOption pobiera opcje zadania określonego zaplanowanego zadania. Obsługiwane są symbole wieloznaczne.

Aby uzyskać nazwy zaplanowanych zadań na komputerze lokalnym lub komputerze zdalnym, użyj Get-ScheduledJob polecenia cmdlet .

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

ScheduledJobDefinition

Do tego polecenia cmdlet można przekazać potok obiektu zaplanowanego zadania.

Dane wyjściowe

ScheduledJobOptions

To polecenie cmdlet zwraca obiekt ScheduledJobOptions .