Get-SqlAgentJobHistory

構文

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>]

説明

Get-SqlAgentJobHistory コマンドレットは、SQL エージェントのターゲット インスタンスに存在する JobHistory オブジェクトを取得します。

このコマンドレットは、JobHistory オブジェクトを取得するための次の操作モードをサポートしています。

• SQL エージェント インスタンスのパスを指定します。
• 入力に SQL エージェントのインスタンスを渡します。
• 有効なコンテキストでコマンドレットを呼び出します。

例

例 1: 指定されたサーバー インスタンスからジョブ履歴全体を取得する

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

このコマンドは、MyServerInstance という名前のサーバー インスタンス内のジョブ履歴全体を取得し、出力を書式設定します。

例 2: 指定されたサーバー インスタンスからジョブ履歴を取得する

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

このコマンドは、"MyServerInstance" という名前のサーバー インスタンス内の ID '187112d7-84e1-4b66-b093-e97201c441ed' のジョブ オブジェクトのジョブ履歴を取得します。

例 3: 指定されたサーバー インスタンスから、期間からジョブ履歴を取得する

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).

このコマンドは、'MyServerInstance' という名前のサーバー インスタンス内の前日からのジョブ履歴を返します。

パラメーター

-AccessToken

-ConnectionTimeout

-Credential

-Encrypt

-EndRunDate

-HostNameInCertificate

-InputObject

-JobID

-JobName

-MinimumRetries

-MinimumRunDurationInSeconds

-OldestFirst

-OutcomesType

-Path

-ProgressAction

-ServerInstance

-Since

-SqlMessageID

-SqlSeverity

-StartRunDate

-TrustServerCertificate

入力

System.String[]

Microsoft.SqlServer.Management.Smo.Agent.JobServer[]

出力

System.Object

関連リンク

• Get-SqlAgent
• Get-SqlAgentJob
• Get-SqlAgentJobSchedule
• Get-SqlAgentJobStep