Get-ScheduledJobOption

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 zadań. 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-ScheduledJobOptionjest jedną z kolekcji poleceń cmdlet planowania zadań w module PSScheduledJob, który jest uwzględniony w Windows PowerShell.

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

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

Przykłady

Przykład 1. Pobieranie opcji zadania

Ten przykład pobiera opcje zadań zaplanowanych zadań pasujących do określonej nazwy.

Get-ScheduledJobOption -Name "*Backup*"

Przykład 2. Pobieranie wszystkich opcji zadań

W tym przykładzie są dostępne opcje zadania 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 zadania 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 pokazują 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. Użyj opcji zadania, aby utworzyć nowe zadanie

W tym przykładzie pokazano, jak używać opcji zadania, 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 polecenia Get-ScheduledJobOption do 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 zaplanowanych opcji 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
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ż potokować obiekt ScheduledJob do Get-ScheduledJobOptionobiektu .

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition
Position:0
Default value:None
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
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Zaplanowane zadanie można potokować z Get-ScheduledJob do Get-ScheduledJobOption.

Dane wyjściowe

Microsoft.PowerShell.ScheduledJob.ScheduledJobOptions