Get-SCOMTaskResult
実行されたタスクの結果を取得します。
構文
Get-SCOMTaskResult
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTaskResult
[-BatchID] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTaskResult
[-Id] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTaskResult
[-Instance] <EnterpriseManagementObject[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTaskResult
[-Task] <ManagementPackTask[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
説明
Get-SCOMTaskResult コマンドレットは、実行されたタスクの結果を取得します。 このコマンドレットを使用して、タスク名または ID、および指定したクラス インスタンスまたはバッチに関連付けられているタスクの結果を取得します。
例
例 1: 部分的な表示名とエラー アクションを指定してタスクの結果を取得する
PS C:\>Get-SCOMTask -Name "*SystemCenter*" | Get-SCOMTaskResult -ErrorAction SilentlyContinue
このコマンドは、名前に SystemCenter があるタスクの結果を取得します。 このコマンドは、Get-SCOMTask コマンドレットを使用して名前に基づいてタスクを取得し、パイプライン演算子を使用して Get-SCOMTaskResult コマンドレットに渡します。 このコマンドは、ErrorAction パラメーターに SilentlyContinue を指定するため、コマンドレットが一致する結果を持たないタスクを検出した場合、コマンドは引き続き実行され、エラー メッセージは表示されません。
例 2: クラス インスタンスを指定してタスクの結果を取得する
PS C:\>Get-SCOMClassInstance -DisplayName "*.Consoso.com" | Get-SCOMTaskResult -ErrorAction SilentlyContinue
このコマンドは、Contoso.com ドメイン内のすべてのクラス インスタンスを取得し、各クラス インスタンス オブジェクトのタスク結果を返します。 このコマンドは、Get-SCOMClassInstance コマンドレットを使用して、.Contoso.com を含む表示名を持つすべてのインスタンスを取得し、パイプライン演算子を使用して Get-SCOMTaskResult コマンドレットに渡します。 このコマンドは、ErrorAction パラメーターに SilentlyContinue を指定するため、コマンドレットが一致するタスクの結果を持たないクラス インスタンスを見つけた場合、コマンドは引き続き実行され、エラー メッセージは表示されません。
例 3: タスク ID を指定してタスクの結果を取得する
PS C:\>Get-SCOMTaskResult -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd
このコマンドは、ID が 7413b06b-a95b-4ae3-98f2-dac9ff76dabd であるタスクの結果を取得します。
例 4: バッチ ID を指定してタスクの結果を取得する
PS C:\>Get-SCOMTaskResult -BatchId 2ef74789-f9f5-46b0-af70-16d01d4f4577
このコマンドは、ID が 2ef74789-f9f5-46b0-af70-16d01d4f4577 のバッチで実行されるタスクの結果を取得します。
パラメーター
-BatchID
タスクを実行するバッチの ID を含む配列を指定します。 コマンドレットは、各バッチのタスクの結果を取得します。
型: | Guid[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ComputerName
接続を確立するコンピューターの名前を含む配列を指定します。 有効な形式には、NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) が含まれます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を指定します。
コンピューターは System Center Data Access サービスを実行する必要があります。
このパラメーターを指定しない場合、既定値は現在の管理グループ接続のコンピューターです。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Credential
管理グループ接続を実行するユーザー アカウントを指定します。
Get-Credential コマンドレットから返されるオブジェクトなど、PSCredential オブジェクトをこのパラメーターに指定します。
資格情報オブジェクトの詳細については、「Get-Help Get-Credential
」と入力します。
このアカウントは、ComputerName パラメーターに指定されているサーバーにアクセスできる必要があります (そのパラメーターが表示される場合)。
このパラメーターを指定しない場合、既定値は現在のユーザーのアカウントです。
型: | PSCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Id
タスク ID の配列を指定します。 コマンドレットは、これらの ID を持つタスクの結果を取得します。
型: | Guid[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Instance
タスクを開始するクラス インスタンスの配列を指定します。 クラス インスタンスを格納する変数を指定するか、クラス インスタンスを取得 Get-SCOMClassInstance などのコマンドレットを使用します。 このパラメーターは、グループ オブジェクトも受け入れます。 グループ オブジェクトを取得するには、Get-SCOMGroup コマンドレットを使用します。
型: | EnterpriseManagementObject[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SCSession
管理サーバーへの接続の配列を指定します。 管理グループ接続オブジェクトを取得するには、Get-SCOMManagementGroupConnection コマンドレットを使用します。 このパラメーターが表示されない場合、既定値は現在の管理グループ接続です。
型: | Connection[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Task
管理パック タスクの配列を指定します。 このコマンドレットは、配列に含まれるタスク オブジェクトの結果を取得します。 タスク オブジェクトを含む変数を指定するか、タスクを取得 Get-SCOMTask コマンドレットなどのコマンドレットを使用します。
型: | ManagementPackTask[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |