Start-SCOMTask

为指定对象启动任务。

语法

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

说明

Start-SCOMTask cmdlet 为指定对象启动任务。 此 cmdlet 将任务对象和类实例对象作为输入。 该 cmdlet 仅接受一个任务,但它可以接受多个类实例和替代。

示例

示例 1:使用显示名称启动任务

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

此示例使用显示名称启动任务。

第一个命令获取 Contoso.com 域中的所有类实例,并将其存储在$Instances变量中。

第二个命令获取显示名称为 Get Monitor 状态的任务,并启动存储在$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

此示例演示如何使用显示名称和指定超时值的哈希表启动任务。

第一个命令创建一个哈希表,该哈希表具有超时键的值,并将其存储在$Overrides变量中。

第二个命令获取名称为 Contoso Service 的所有类实例,并将其存储在$Instances变量中。

第三个命令获取显示名称为“启动 NT 服务”的任务,并为存储在$Instances变量中的每个类实例启动该任务。

第四个命令启动存储在$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变量中。

第二个命令获取名为 Server01.Contoso.com 的类实例,并将其存储在$Instance变量中。

第三个命令获取具有显示名称重置状态的任务,并启动存储在$Instance中的类实例的任务。 该命令在存储在$Credential中的凭据下运行任务。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Instance

指定要为其启动任务的类实例对象的 EnterpriseManagementObject 对象的数组。 指定存储类实例或使用 cmdlet(例如获取类实例的 Get-SCOMClassInstance cmdlet)的变量。 此参数还接受组对象。 若要获取组对象,请使用 Get-SCOMGroup cmdlet。

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

-Override

指定一个哈希表,如果这些参数允许重写,则为一个或多个任务参数定义新值。 有关哈希表的详细信息,请键入“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 cmdlet 等 cmdlet。 此参数仅接受一个任务对象。

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

-TaskCredentials

指定管理组连接运行所在的用户帐户。 为此参数指定 PSCredential 对象,例如 Get-Credential cmdlet 返回的对象。 有关凭据对象的详细信息,请键入“Get-Help Get-Credential”。

如果出现该参数,则此帐户必须有权访问 ComputerName 参数中指定的服务器。

这是必需的参数。 如果指定空值,Operations Manager 将使用当前用户帐户的默认 TaskCredentials。

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

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

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