次の方法で共有

Start-SCOMTask

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

指定したオブジェクトのタスクを開始します。

構文

Start-SCOMTask
     [-Instance] <EnterpriseManagementObject[]>
     [-Task] <ManagementPackTask>
     -TaskCredentials <PSCredential>
     [[-Override] <Hashtable>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

Start-SCOMTask コマンドレットは、指定したオブジェクトのタスクを開始します。 このコマンドレットは、タスク オブジェクトとクラス インスタンス オブジェクトを入力として受け取ります。 コマンドレットは 1 つのタスクのみを受け入れますが、複数のクラス インスタンスとオーバーライドを受け入れることもできます。

例

例 1: 表示名を使用してタスクを開始する

PS C:\>$Instances = Get-SCOMClassInstance -Name "*.Contoso.com"
PS C:\> Get-SCOMTask -DisplayName "Get Monitor State" | Start-SCOMTask -Instance $Instances

次の使用例は、表示名を使用してタスクを開始します。

最初のコマンドは、Contoso.com ドメイン内のすべてのクラス インスタンスを取得し、$Instances変数に格納します。

2 番目のコマンドは、表示名 Get Monitor State を持つタスクを取得し、$Instances変数に格納されている各クラス インスタンスのタスクを開始します。

例 2: 表示名とタイムアウト指定を使用してタスクを開始する

PS C:\>$Overrides = @{Timeout=60}
PS C:\> $Instances = Get-SCOMClassInstance -DisplayName "Contoso Service"
PS C:\> $Task = Get-SCOMTask -DisplayName "Start NT Service"
PS C:\> Start-SCOMTask -Task $Task -Instance $Instances -Override $Overrides

この例では、タイムアウト値を指定する表示名とハッシュ テーブルを使用してタスクを開始する方法を示します。

最初のコマンドは、Timeout キーの値を持つハッシュ テーブルを作成し、$Overrides変数に格納します。

2 番目のコマンドは、Contoso Service という名前のすべてのクラス インスタンスを取得し、$Instances変数に格納します。

3 番目のコマンドは、表示名 Start NT Service を持つタスクを取得し、$Instances変数に格納されている各クラス インスタンスのタスクを開始します。

4 番目のコマンドは、$Instances変数に格納されている各クラス インスタンスのタスクを開始します。 このコマンドは、タイムアウト キー値 60 を指定します。

例 3: 資格情報を使用してタスクを開始する

PS C:\>$Credential = Get-Credential
PS C:\> $Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> Get-SCOMTask -DisplayName "Reset State" | Start-SCOMTask -Instance $Instance -TaskCredentials $Credential

この例では、資格情報を使用してタスクを開始します。

最初のコマンドは、ユーザーにユーザー名とパスワードの入力を求め、入力から資格情報オブジェクトを作成し、資格情報オブジェクトを$Credential変数に格納します。

2 番目のコマンドは、Server01.Contoso.com という名前のクラス インスタンスを取得し、$Instance変数に格納します。

3 番目のコマンドは、表示名 Reset State を持つタスクを取得し、$Instanceに格納されているクラス インスタンスのタスクを開始します。 このコマンドは、$Credentialに格納されている資格情報でタスクを実行します。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Instance

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

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

-Override

1 つ以上のタスク パラメーターの新しい値を定義するハッシュ テーブルを指定します (これらのパラメーターでオーバーライドが許可されている場合)。 ハッシュ テーブルの詳細については、「」Get-Help about_Hash_Tablesと入力します。

オーバーライドを許可するタスクのパラメーターを確認するには、タスク オブジェクトの GetOverrideableParameters メソッドを使用します。

Type:Hashtable
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Task

開始するタスク オブジェクトを指定します。 タスクを表す変数を指定するか、タスクを取得する Get-SCOMTask コマンドレットなどのコマンドレットを使用します。 このパラメーターは、1 つのタスク オブジェクトのみを受け入れます。

Type:ManagementPackTask
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TaskCredentials

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

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

これは必須パラメーターです。 null 値を指定すると、Operations Manager は現在のユーザーのアカウントの既定の TaskCredentials を使用します。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False