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 を含む配列を指定します。 コマンドレットは、各バッチのタスクの結果を取得します。
Type: | Guid[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
接続を確立するコンピューターの名前を含む配列を指定します。 有効な形式は、NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) です。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を指定します。
コンピューターで System Center Data Access サービスを実行する必要があります。
このパラメーターを指定しない場合、既定値は現在の管理グループ接続のコンピューターです。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
管理グループ接続を実行するユーザー アカウントを指定します。
このパラメーターに対して、Get-Credential コマンドレットから返される PSCredential オブジェクト ( Get-Credential コマンドレットが返すオブジェクトなど) を指定します。
資格情報オブジェクトの詳細については、「.」と入力します Get-Help Get-Credential
。
このアカウントは、そのパラメーターが表示される場合は、 ComputerName パラメーターで指定されているサーバーにアクセスできる必要があります。
このパラメーターを指定しない場合、既定値は現在のユーザーのアカウントです。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
タスク ID の配列を指定します。 コマンドレットは、これらの ID を持つタスクの結果を取得します。
Type: | Guid[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Instance
タスクを開始するクラス インスタンスの配列を指定します。 クラス インスタンスを格納する変数を指定するか、クラス インスタンスを取得する Get-SCOMClassInstance などのコマンドレットを使用します。 このパラメーターは、グループ オブジェクトも受け入れます。 グループ オブジェクトを取得するには、 Get-SCOMGroup コマンドレットを使用します。
Type: | EnterpriseManagementObject[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SCSession
管理サーバーへの接続の配列を指定します。 管理グループ接続オブジェクトを取得するには、 Get-SCOMManagementGroupConnection コマンドレットを 使用します。 このパラメーターが表示されない場合、既定値は現在の管理グループ接続です。
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Task
管理パック タスクの配列を指定します。 このコマンドレットは、配列に含まれるタスク オブジェクトの結果を取得します。 タスク オブジェクトを含む変数を指定するか、タスクを取得する Get-SCOMTask コマンドレットなどのコマンドレットを使用します。
Type: | ManagementPackTask[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |