Bagikan melalui

Get-ScheduledJobOption

Modul:
PSScheduledJob Module

Mendapatkan opsi pekerjaan dari pekerjaan terjadwal.

Sintaks

JobDefinition (Default) 

Get-ScheduledJobOption
    [-InputObject] <ScheduledJobDefinition>
    [<CommonParameters>]

JobDefinitionId 

Get-ScheduledJobOption
    [-Id] <Int32>
    [<CommonParameters>]

JobDefinitionName 

Get-ScheduledJobOption
    [-Name] <String>
    [<CommonParameters>]

Deskripsi

cmdlet Get-ScheduledJobOption mendapatkan opsi pekerjaan pekerjaan terjadwal. Anda dapat menggunakan perintah ini untuk memeriksa opsi pekerjaan atau untuk menyalurkan opsi pekerjaan ke cmdlet lain.

Opsi pekerjaan tidak disimpan ke disk secara independen; mereka adalah bagian dari pekerjaan terjadwal. Untuk mendapatkan opsi pekerjaan dari pekerjaan terjadwal, tentukan pekerjaan terjadwal.

Gunakan parameter cmdlet Get-ScheduledJobOption untuk mengidentifikasi pekerjaan terjadwal. Anda dapat mengidentifikasi pekerjaan terjadwal berdasarkan nama atau nomor identifikasinya, atau dengan memasukkan atau mempipa objek ScheduledJob, seperti yang dikembalikan oleh cmdlet Get-ScheduledJob, ke Get-ScheduledJobOption.

Get-ScheduledJobOption adalah salah satu kumpulan cmdlet penjadwalan pekerjaan dalam modul PSScheduledJob yang disertakan dalam Windows PowerShell.

Untuk informasi selengkapnya tentang Pekerjaan Terjadwal, lihat topik Tentang dalam modul PSScheduledJob. Impor modul PSScheduledJob lalu ketik: Get-Help about_Scheduled* atau lihat about_Scheduled_Jobs.

Cmdlet ini diperkenalkan di Windows PowerShell 3.0.

Contoh

Contoh 1: Dapatkan opsi pekerjaan

Contoh ini mendapatkan opsi pekerjaan pekerjaan terjadwal yang cocok dengan nama tertentu.

Get-ScheduledJobOption -Name "*Backup*"

Contoh 2: Dapatkan semua opsi pekerjaan

Contoh ini mendapatkan opsi pekerjaan dari semua pekerjaan terjadwal di komputer lokal.

Get-ScheduledJob | Get-ScheduledJobOption

Contoh menggunakan cmdlet Get-ScheduledJob untuk mendapatkan pekerjaan terjadwal di komputer lokal. Operator alur (|) mengirim pekerjaan terjadwal ke cmdlet Get-ScheduledJobOption, yang mendapatkan opsi pekerjaan dari setiap pekerjaan terjadwal.

Contoh 3: Dapatkan opsi pekerjaan yang dipilih

Contoh ini menunjukkan cara menemukan objek opsi pekerjaan dengan nilai tertentu.

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

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

Perintah pertama mendapatkan opsi pekerjaan di mana properti RunElevated memiliki nilai $true dan properti RunWithoutNetwork memiliki nilai $false. Output menunjukkan objek JobOptions yang dipilih.

Perintah kedua menunjukkan cara menemukan pekerjaan terjadwal tempat opsi pekerjaan berada. Perintah ini menggunakan operator alur (|) untuk mengirim opsi pekerjaan yang dipilih ke cmdlet ForEach-Object, yang mendapatkan properti JobDefinition dari setiap objek opsi. Properti JobDefinition berisi objek pekerjaan asal.

Contoh 4: Gunakan opsi pekerjaan untuk membuat pekerjaan baru

Contoh ini menunjukkan cara menggunakan opsi pekerjaan yang Get-ScheduledJobOption dapatkan dalam pekerjaan terjadwal baru.

$registerScheduledJobSplat = @{
    Name = "Archive-Scripts"
    FilePath = "\\Srv01\Scripts\ArchiveScripts.ps1"
    ScheduledJobOption = Get-ScheduledJobOption -Name "BackupTestLogs"
}
Register-ScheduledJob @registerScheduledJobSplat

Perintah pertama menggunakan Get-ScheduledJobOption untuk mendapatkan opsi pekerjaan dari pekerjaan terjadwal BackupTestLogs. Perintah menyimpan opsi dalam variabel $Opts.

Perintah kedua menggunakan cmdlet Register-ScheduledJob untuk membuat pekerjaan terjadwal baru. Nilai parameter ScheduledJobOption adalah objek opsi dalam variabel $Opts.

Contoh 5: Mendapatkan opsi pekerjaan dari komputer jarak jauh

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

Perintah ini menggunakan cmdlet Invoke-Command untuk mendapatkan opsi pekerjaan terjadwal dari pekerjaan DataDemon di komputer Srv01. Perintah menyimpan opsi dalam variabel $O.

Parameter

-Id

Menentukan nomor identifikasi pekerjaan terjadwal. Get-ScheduledJobOption mendapatkan opsi pekerjaan dari pekerjaan terjadwal yang ditentukan.

Untuk mendapatkan nomor identifikasi pekerjaan terjadwal di komputer lokal atau komputer jarak jauh, gunakan cmdlet Get-ScheduledJob.

Properti parameter

Jenis:Int32
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

JobDefinitionId
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-InputObject

Menentukan pekerjaan terjadwal. Masukkan variabel yang berisi objek ScheduledJob atau ketik perintah atau ekspresi yang mendapatkan objek ScheduledJob, seperti perintah Get-ScheduledJob. Anda juga dapat menyalurkan objek ScheduledJob ke Get-ScheduledJobOption.

Properti parameter

Jenis:ScheduledJobDefinition
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

JobDefinition
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Name

Menentukan nama pekerjaan terjadwal. Get-ScheduledJobOption mendapatkan opsi pekerjaan dari pekerjaan terjadwal yang ditentukan. Penggunaan wildcard didukung.

Untuk mendapatkan nama pekerjaan terjadwal di komputer lokal atau komputer jarak jauh, gunakan cmdlet Get-ScheduledJob.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

JobDefinitionName
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

ScheduledJobDefinition

Anda dapat menyalurkan objek pekerjaan terjadwal ke cmdlet ini.

Output

ScheduledJobOptions

Cmdlet ini mengembalikan objek ScheduledJobOptions.