Get-SqlAgentJobHistory
Mendapatkan riwayat pekerjaan yang ada dalam instans target Agen SQL.
Sintaks
Get-SqlAgentJobHistory
[-StartRunDate <DateTime>]
[-EndRunDate <DateTime>]
[-JobID <Guid>]
[-JobName <String>]
[-MinimumRetries <Int32>]
[-MinimumRunDurationInSeconds <Int32>]
[-OldestFirst]
[-OutcomesType <CompletionResult>]
[-SqlMessageID <Int32>]
[-SqlSeverity <Int32>]
[-Since <SinceType>]
[[-Path] <String[]>]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-ProgressAction <ActionPreference>]
[<CommonParameters>]
Get-SqlAgentJobHistory
[-StartRunDate <DateTime>]
[-EndRunDate <DateTime>]
[-JobID <Guid>]
[-JobName <String>]
[-MinimumRetries <Int32>]
[-MinimumRunDurationInSeconds <Int32>]
[-OldestFirst]
[-OutcomesType <CompletionResult>]
[-SqlMessageID <Int32>]
[-SqlSeverity <Int32>]
[-Since <SinceType>]
[[-ServerInstance] <String[]>]
[-Credential <PSCredential>]
[-ConnectionTimeout <Int32>]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-ProgressAction <ActionPreference>]
[<CommonParameters>]
Get-SqlAgentJobHistory
[-StartRunDate <DateTime>]
[-EndRunDate <DateTime>]
[-JobID <Guid>]
[-JobName <String>]
[-MinimumRetries <Int32>]
[-MinimumRunDurationInSeconds <Int32>]
[-OldestFirst]
[-OutcomesType <CompletionResult>]
[-SqlMessageID <Int32>]
[-SqlSeverity <Int32>]
[-Since <SinceType>]
[-InputObject] <JobServer[]>
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-ProgressAction <ActionPreference>]
[<CommonParameters>]
Deskripsi
Cmdlet Get-SqlAgentJobHistory mendapatkan objek JobHistory yang ada dalam instans target Agen SQL.
Cmdlet ini mendukung mode operasi berikut untuk mendapatkan objek JobHistory:
- Tentukan jalur instans SQL Agent.
- Berikan instans Agen SQL dalam input.
- Panggil cmdlet dalam konteks yang valid.
Contoh
Contoh 1: Mendapatkan seluruh riwayat pekerjaan dari instans server yang ditentukan
PS C:\> Get-SqlAgentJobHistory -ServerInstance "MyServerInstance" | Format-Table
InstanceID SqlMessageID Message
---------- ------------ -------
34 0 The job succeeded. The Job was invoked by Schedule 8 (syspolicy_purge_history_schedule). T...
33 0 Executed as user: DOMAIN\Machine1$. The step did not generate any output. Process Exit
Perintah ini mendapatkan seluruh riwayat pekerjaan dalam instans server bernama MyServerInstance lalu memformat output.
Contoh 2: Dapatkan riwayat pekerjaan dari instans server yang ditentukan
PS C:\> Get-SqlAgentJobHistory -ServerInstance "MyServerInstance" -JobID 187112d7-84e1-4b66-b093-e97201c441ed
JobID : 187112d7-84e1-4b66-b093-e97201c441ed
JobName : Job_73cc6990-6386-49f9-9826-96c318ad8afa
RunStatus : 3
Perintah ini mendapatkan riwayat pekerjaan objek pekerjaan dengan ID '187112d7-84e1-4b66-b093-e97201c441ed' dalam instans server bernama 'MyServerInstance'.
Contoh 3: Dapatkan riwayat pekerjaan dari durasi waktu dari instans server yang ditentukan
PS C:\> Get-SqlAgentJobHistory -ServerInstance "MyServerInstance" -Since Yesterday
InstanceID : 4
SqlMessageID : 0
Message : The job was stopped prior to completion by User admin. The Job was invoked by User
admin. The last step to run was step 1 (JobStep_3e4cd4ba-3433-4311-a6a2-816884101504).
Perintah ini mengembalikan riwayat pekerjaan sejak sehari sebelumnya di instans server bernama 'MyServerInstance'.
Parameter
-AccessToken
Token akses yang digunakan untuk mengautentikasi ke SQL Server, sebagai alternatif untuk pengguna/kata sandi atau Autentikasi Windows.
Ini dapat digunakan, misalnya, untuk menyambungkan ke SQL Azure DB
dan SQL Azure Managed Instance
menggunakan Service Principal
atau Managed Identity
.
Parameter yang digunakan dapat berupa string yang mewakili token atau objek PSAccessToken
seperti yang dikembalikan dengan menjalankan Get-AzAccessToken -ResourceUrl https://database.windows.net
.
Parameter ini baru dalam v22 modul.
Jenis: | PSObject |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ConnectionTimeout
Menentukan jumlah detik untuk menunggu koneksi server sebelum kegagalan waktu habis. Nilai waktu habis harus berupa nilai bilangan bulat antara 0 dan 65534. Jika 0 ditentukan, upaya koneksi tidak kehabisan waktu.
Jenis: | Int32 |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Credential
Menentukan objek PSCredential yang digunakan untuk menentukan kredensial untuk login SQL Server yang memiliki izin untuk melakukan operasi ini.
Jenis: | PSCredential |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Encrypt
Jenis enkripsi yang akan digunakan saat menyambungkan ke SQL Server.
Nilai ini memetakan ke properti Encrypt
SqlConnectionEncryptOption
pada objek SqlConnection driver Microsoft.Data.SqlClient.
Dalam v22 modul, defaultnya adalah Optional
(untuk kompatibilitas dengan v21). Dalam v23+ modul, nilai defaultnya adalah 'Wajib', yang dapat membuat perubahan yang melanggar untuk skrip yang ada.
Parameter ini baru dalam v22 modul.
Jenis: | String |
Nilai yang diterima: | Mandatory, Optional, Strict |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-EndRunDate
Menentukan batasan filter pekerjaan yang membatasi nilai yang dikembalikan ke tanggal pekerjaan selesai.
Jenis: | DateTime |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-HostNameInCertificate
Nama host yang akan digunakan dalam memvalidasi sertifikat SQL Server TLS/SSL. Anda harus meneruskan parameter ini jika instans SQL Server Anda diaktifkan untuk Enkripsi Paksa dan Anda ingin terhubung ke instans menggunakan nama host/nama pendek. Jika parameter ini dihilangkan, maka meneruskan Nama Domain yang Sepenuhnya Memenuhi Syarat (FQDN) ke -ServerInstance diperlukan untuk terhubung ke instans SQL Server yang diaktifkan untuk Enkripsi Paksa.
Parameter ini baru dalam v22 modul.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-InputObject
Menentukan array objek SQL Server Management Object (SMO) yang mewakili SQL Server Agent yang ditargetkan.
Jenis: | JobServer[] |
Position: | 1 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-JobID
Menentukan batasan filter pekerjaan yang membatasi nilai yang dikembalikan ke pekerjaan yang ditentukan oleh nilai ID pekerjaan.
Jenis: | Guid |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-JobName
Menentukan batasan filter pekerjaan yang membatasi nilai yang dikembalikan ke pekerjaan yang ditentukan oleh nama pekerjaan.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-MinimumRetries
Menentukan batasan filter pekerjaan yang membatasi nilai yang dikembalikan ke pekerjaan yang gagal dan telah dicoba kembali untuk jumlah waktu minimum.
Jenis: | Int32 |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-MinimumRunDurationInSeconds
Menentukan batasan filter pekerjaan yang membatasi nilai yang dikembalikan ke pekerjaan yang telah selesai dalam jangka waktu minimum yang ditentukan, dalam hitungan detik.
Jenis: | Int32 |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-OldestFirst
Menunjukkan bahwa cmdlet ini mencantumkan pekerjaan dalam urutan terlama-pertama. Jika Anda tidak menentukan parameter ini, cmdlet menggunakan urutan pertama terbaru.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-OutcomesType
Menentukan batasan filter pekerjaan yang membatasi nilai yang dikembalikan ke pekerjaan yang memiliki hasil yang ditentukan saat penyelesaian.
Nilai yang dapat diterima untuk parameter ini adalah:
-- Gagal -- Berhasil -- Coba Lagi -- Dibatalkan -- InProgress -- Tidak diketahui
Jenis: | CompletionResult |
Nilai yang diterima: | Failed, Succeeded, Retry, Cancelled, InProgress, Unknown |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Path
Menentukan jalur ke Agen SQL Server, sebagai array, tempat cmdlet ini menjalankan operasi. Jika Anda tidak menentukan nilai untuk parameter ini, cmdlet menggunakan lokasi kerja saat ini.
Jenis: | String[] |
Position: | 1 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ProgressAction
Menentukan bagaimana PowerShell merespons pembaruan kemajuan yang dihasilkan oleh skrip, cmdlet, atau penyedia, seperti bilah kemajuan yang dihasilkan oleh cmdlet Write-Progress. cmdlet Write-Progress membuat bilah kemajuan yang memperlihatkan status perintah.
Jenis: | ActionPreference |
Alias: | proga |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ServerInstance
Menentukan nama instans SQL Server, sebagai array, tempat Agen SQL berjalan. Untuk instans default, hanya tentukan nama komputer: MyComputer. Untuk instans bernama, gunakan format ComputerName\InstanceName.
Jenis: | String[] |
Position: | 1 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Since
Menentukan singkatan yang dapat Anda gunakan alih-alih parameter StartRunDate.
Ini dapat ditentukan dengan parameter EndRunDate.
Anda tidak dapat menggunakan parameter StartRunDate, jika Anda menggunakan parameter ini.
Nilai yang dapat diterima untuk parameter ini adalah:
- Tengah malam (mendapatkan semua informasi riwayat pekerjaan yang dihasilkan setelah tengah malam)
- Kemarin (mendapatkan semua informasi riwayat pekerjaan yang dihasilkan dalam 24 jam terakhir)
- LastWeek (mendapatkan semua informasi riwayat pekerjaan yang dihasilkan dalam seminggu terakhir)
- LastMonth (mendapatkan semua informasi riwayat pekerjaan yang dihasilkan dalam sebulan terakhir)
Jenis: | SinceType |
Nilai yang diterima: | Midnight, Yesterday, LastWeek, LastMonth |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-SqlMessageID
Menentukan batasan filter pekerjaan yang membatasi nilai yang dikembalikan ke pekerjaan yang telah menghasilkan pesan yang ditentukan selama runtime.
Jenis: | Int32 |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-SqlSeverity
Menentukan batasan filter pekerjaan yang membatasi nilai yang dikembalikan ke pekerjaan yang telah menghasilkan kesalahan tingkat keparahan yang ditentukan selama runtime.
Jenis: | Int32 |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-StartRunDate
Menentukan batasan filter pekerjaan yang membatasi nilai yang dikembalikan ke tanggal pekerjaan dimulai.
Jenis: | DateTime |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-TrustServerCertificate
Menunjukkan apakah saluran akan dienkripsi saat melewati rantai sertifikat untuk memvalidasi kepercayaan.
Dalam v22 modul, defaultnya adalah $true
(untuk kompatibilitas dengan v21). Dalam v23+ modul, nilai defaultnya adalah '$false', yang dapat membuat perubahan yang melanggar untuk skrip yang ada.
Parameter ini baru dalam v22 modul.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
Input
System.String[]
Microsoft.SqlServer.Management.Smo.Agent.JobServer[]
Output
System.Object
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk