Get-SCOMTask

  • リファレンス
モジュール:
OperationsManager

タスクの一覧を取得します。

構文

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 サービスを実行する必要があります。

このパラメーターを指定しない場合、既定値は現在の管理グループ接続のコンピューターです。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

管理グループ接続を実行するユーザー アカウントを指定します。 このパラメーターに対して、Get-Credential コマンドレットから返される PSCredential オブジェクト (例: PSCredential オブジェクト) を指定します。 資格情報オブジェクトの詳細については、「」Get-Help Get-Credentialと入力します。

このアカウントは、そのパラメーターが表示される場合、 ComputerName パラメーターで指定されているサーバーにアクセスできる必要があります。

このパラメーターを指定しない場合、既定値は現在のユーザーのアカウントです。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

タスク オブジェクトの表示名の配列を指定します。 このパラメーターは 1 つ以上の文字列を受け取り、コマンドレットが使用するタスク オブジェクトの表示名の一致を検索します。 このパラメーターの値は、管理グループにインポートされるローカライズされた管理パックと、Windows PowerShell実行するユーザーのロケールによって異なります。

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Id

タスク ID の配列を指定します。 コマンドレットは、これらの ID を持つタスクを取得します。 タスクを取得するには、 Get-SCOMTask コマンドレットを 使用します。 ID は、タスク オブジェクトの ID プロパティです。

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Instance

クラス インスタンスを表す EnterpriseManagementObject オブジェクトの配列を指定します。 このコマンドレットは、配列が格納するクラス インスタンスのタスクを取得します。 クラス インスタンスを表す変数を指定するか、クラス インスタンスを取得する Get-SCOMClassInstance などのコマンドレットを使用します。 このパラメーターは、グループ オブジェクトも受け入れます。 グループ オブジェクトを取得するには、 Get-SCOMGroup コマンドレットを使用します。

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementPack

管理パック オブジェクトの配列を指定します。 コマンドレットは、配列内の管理パック オブジェクトのタスクを取得します。 管理パック オブジェクトを含む変数を指定するか、管理パック オブジェクトを取得する Get-SCOMManagementPack などのコマンドレットを使用します。

Type:ManagementPack[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

タスク名の配列を指定します。

このコマンドレットは、配列内の各文字列を受け取り、このコマンドレットが使用するタスク オブジェクトの Name プロパティと一致します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-SCSession

Connection オブジェクトの配列を指定します。 接続オブジェクトを取得するには、Get-SCOMManagementGroupConnection コマンドレットを指定します。

このパラメーターが表示されない場合、コマンドレットは管理グループへのアクティブな永続的な接続を使用します。 SCSession パラメーターを使用して、別の永続的な接続を指定します。 ComputerName パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。 詳細については、「」Get-Help about_OpsMgr_Connectionsと入力します。

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Target

ターゲット クラスを表す管理パック クラス オブジェクトの配列を指定します。 ターゲット クラス オブジェクトを含む変数を指定するか、ターゲット クラス オブジェクトを取得する Get-SCOMClass などのコマンドレットを使用します。

Type:ManagementPackClass[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False