Get-ScheduledJobOption

Modül:
PSScheduledJob Module

Zamanlanmış işlerin iş seçeneklerini alır.

Syntax

JobDefinition (Varsayılan) 

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

JobDefinitionId 

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

JobDefinitionName 

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

Description

Get-ScheduledJobOption cmdlet'i zamanlanmış işlerin iş seçeneklerini alır. İş seçeneklerini incelemek veya iş seçeneklerini diğer cmdlet'lere yöneltmek için bu komutu kullanabilirsiniz.

İş seçenekleri diske bağımsız olarak kaydedilmez; bunlar zamanlanmış bir işin parçasıdır. Zamanlanmış işin iş seçeneklerini almak için zamanlanmış işi belirtin.

Zamanlanmış işi tanımlamak için Get-ScheduledJobOption cmdlet'in parametrelerini kullanın. Zamanlanmış işleri adlarına veya kimlik numaralarına göre veya Get-ScheduledJob nesnelerini Get-ScheduledJobOptiongirerek veya ekleyerek tanımlayabilirsiniz.

Get-ScheduledJobOption, Windows PowerShell'de bulunan PSScheduledJob modülündeki iş zamanlama cmdlet'lerinden oluşan bir koleksiyondur.

Zamanlanmış İşler hakkında daha fazla bilgi için PSScheduledJob modülündeki Hakkında konu başlıklarına bakın. PSScheduledJob modülünü içeri aktarın ve şunu yazın: Get-Help about_Scheduled* veya bkz. about_Scheduled_Jobs.

Bu cmdlet, Windows PowerShell 3.0'da kullanıma sunulmuştur.

Örnekler

Örnek 1: İş seçeneklerini alma

Bu örnek, belirtilen adla eşleşen zamanlanmış işlerin iş seçeneklerini alır.

Get-ScheduledJobOption -Name "*Backup*"

Örnek 2: Tüm iş seçeneklerini alma

Bu örnek, yerel bilgisayardaki tüm zamanlanmış işlerin iş seçeneklerini alır.

Get-ScheduledJob | Get-ScheduledJobOption

Örnek, zamanlanmış işleri yerel bilgisayara almak için Get-ScheduledJob cmdlet'ini kullanır. İşlem hattı işleci (|), zamanlanmış işleri Get-ScheduledJobOption cmdlet'ine gönderir ve bu da zamanlanan her işin iş seçeneklerini alır.

Örnek 3: Seçili iş seçeneklerini alma

Bu örnekte, belirli değerlere sahip iş seçenekleri nesnesinin nasıl bulunacakları gösterilmektedir.

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

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

İlk komut, RunElevated özelliğinin $true değerine ve RunWithoutNetwork özelliğinin değerine $falsesahip olduğu iş seçeneklerini alır. Çıktı, seçilen JobOptions nesnesini gösterir.

İkinci komut, iş seçeneklerinin hangi zamanlanmış işe ait olduğunu bulma işlemini gösterir. Bu komut, seçilen iş seçeneklerini | cmdlet'ine göndermek için bir işlem hattı işleci (ForEach-Object) kullanır ve bu da her seçenek nesnesinin jobDefinition özelliğini alır. JobDefinition özelliği kaynak iş nesnesini içerir.

Örnek 4: Yeni iş oluşturmak için iş seçeneklerini kullanma

Bu örnekte, Get-ScheduledJobOption yeni bir zamanlanmış işe alınan iş seçeneklerinin nasıl kullanılacağı gösterilmektedir.

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

İlk komut, BackupTestLogs zamanlanmış işinin iş seçeneklerini almak için Get-ScheduledJobOption kullanır. komutu, seçenekleri $Opts değişkenine kaydeder.

İkinci komut, yeni bir zamanlanmış iş oluşturmak için Register-ScheduledJob cmdlet'ini kullanır. ScheduledJobOption parametresinin değeri, $Opts değişkenindeki options nesnesidir.

Örnek 5: Uzak bilgisayardan iş seçeneklerini alma

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

Bu komut, Srv01 bilgisayarındaki DataDemon işinin zamanlanmış iş seçeneklerini almak için Invoke-Command cmdlet'ini kullanır. komutu, seçenekleri $O değişkenine kaydeder.

Parametreler

-Id

Zamanlanmış işin kimlik numarasını belirtir. Get-ScheduledJobOption belirtilen zamanlanmış işin iş seçeneklerini alır.

Yerel bilgisayarda veya uzak bilgisayarda zamanlanmış işlerin kimlik numaralarını almak için Get-ScheduledJob cmdlet'ini kullanın.

Parametre özellikleri

Tür:Int32
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

JobDefinitionId
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-InputObject

Zamanlanmış bir işi belirtir. ScheduledJob nesnesi içeren bir değişken girin veya komutu gibi bir Get-ScheduledJob nesnesi alan bir komut veya ifade yazın. Bir ScheduledJob nesnesini Get-ScheduledJobOption'e de yöneltebilirsiniz.

Parametre özellikleri

Tür:ScheduledJobDefinition
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

JobDefinition
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Name

Zamanlanmış işlerin adlarını belirtir. Get-ScheduledJobOption belirtilen zamanlanmış işin iş seçeneklerini alır. Joker karakterler desteklenmektedir.

Yerel bilgisayarda veya uzak bilgisayarda zamanlanmış işlerin adlarını almak için Get-ScheduledJob cmdlet'ini kullanın.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

JobDefinitionName
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

ScheduledJobDefinition

Zamanlanmış bir iş nesnesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

ScheduledJobOptions

Bu cmdlet bir ScheduledJobOptions nesnesi döndürür.