Get-SCOMTask
タスクの一覧を取得します。
構文
Get-SCOMTask
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTask
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTask
-Id <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTask
[-Instance] <EnterpriseManagementObject[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTask
[-ManagementPack] <ManagementPack[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTask
[-Name <String[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTask
[-Target <ManagementPackClass[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
説明
Get-SCOMTask コマンドレットは、タスクの一覧を取得します。 このコマンドレットを使用して、特定の名前または ID を持つタスク、および指定されたユーザー ロール、クラス インスタンス、管理パック、またはターゲット クラスに関連付けられているタスクを取得します。
例
例 1: 部分名を指定してタスクを取得する
PS C:\>Get-SCOMTask -Name "*health*"
このコマンドは、名前に正常性があるすべてのタスクを取得します。
例 2: 部分的な表示名を使用してタスクを取得する
PS C:\>Get-SCOMTask -DisplayName "Stop*"
このコマンドは、Stop で始まる表示名を持つすべてのタスクを取得します。
例 3: 部分的な表示名とエラー アクションを指定してタスクを取得する
PS C:\>Get-SCOMManagementPack -DisplayName "System Center Core*" | Get-SCOMTask -ErrorAction SilentlyContinue
このコマンドは、表示名に System Center Core がある管理パックのすべてのタスクを取得します。 このコマンドは、Get-SCOMManagementPack コマンドレットを使用して、表示名に基づいて管理パックを取得し、Get-SCOMTask コマンドレットに渡します。 このコマンドは、ErrorAction パラメーターに SilentlyContinue を指定するため、コマンドレットでタスクが関連付けられていない管理パックが見つかると、実行が続行され、エラー メッセージは表示されません。
例 4: 部分クラス名を使用してタスクを取得する
PS C:\>Get-SCOMClass -Name "*health*" | Get-SCOMTask
このコマンドは、名前に正常性があるクラスのすべてのタスクを取得します。
例 5: 部分クラス インスタンス名を指定してタスクを取得する
PS C:\>Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMTask
このコマンドは、名前に .Contoso.com を持つクラス インスタンスのすべてのタスクを取得します。
例 6: ID を指定してタスクを取得する
PS C:\>Get-SCOMTask -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd
このコマンドは、ID が 7413b06b-a95b-4ae3-98f2-dac9ff76dabd のタスクを取得します。
パラメーター
-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 |
-DisplayName
タスク オブジェクトの表示名の配列を指定します。 このパラメーターは 1 つ以上の文字列を受け取り、コマンドレットが使用するタスク オブジェクトの表示名の一致を検索します。 このパラメーターの値は、Windows PowerShell を実行するユーザーの管理グループとロケールにインポートされるローカライズされた管理パックによって異なります。
型: | String[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | True |
-Id
タスク ID の配列を指定します。 コマンドレットは、これらの ID を持つタスクを取得します。 タスクを取得するには、Get-SCOMTask コマンドレットを使用します。 ID は、タスク オブジェクトの ID プロパティです。
型: | Guid[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Instance
クラス インスタンスを表す EnterpriseManagementObject オブジェクトの配列を指定します。 このコマンドレットは、配列が格納するクラス インスタンスのタスクを取得します。 クラス インスタンスを表す変数を指定するか、クラス インスタンスを取得 Get-SCOMClassInstance などのコマンドレットを使用します。 このパラメーターは、グループ オブジェクトも受け入れます。 グループ オブジェクトを取得するには、Get-SCOMGroup コマンドレットを使用します。
型: | EnterpriseManagementObject[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ManagementPack
管理パック オブジェクトの配列を指定します。 このコマンドレットは、配列内の管理パック オブジェクトのタスクを取得します。 管理パック オブジェクトを含む変数を指定するか、管理パック オブジェクトを取得 Get-SCOMManagementPack などのコマンドレットを使用します。
型: | ManagementPack[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
タスク名の配列を指定します。
このコマンドレットは、配列内の各文字列を受け取り、このコマンドレットが使用するタスク オブジェクトの Name プロパティと一致します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | True |
-SCSession
Connection オブジェクトの配列
このパラメーターが表示されない場合、コマンドレットは管理グループへのアクティブな永続的な接続を使用します。
SCSession パラメーターを使用して、別の永続的な接続を指定します。
ComputerName パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。
詳細については、「Get-Help about_OpsMgr_Connections
」と入力します。
型: | Connection[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Target
ターゲット クラスを表す管理パック クラス オブジェクトの配列を指定します。 ターゲット クラス オブジェクトを含む変数を指定するか、ターゲット クラス オブジェクトを取得 Get-SCOMClass などのコマンドレットを使用します。
型: | ManagementPackClass[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |