Start-SCOMTask

为指定对象启动任务。

语法

Default (默认值)

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 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 变量中。

第二个命令获取名称为 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 变量中。

第三个命令获取显示名称为 Reset State 的任务,并为存储在 $Instance 中的类实例启动任务。 该命令在存储在$Credential中的凭据下运行任务。

参数

-Confirm

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

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Instance

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

参数属性

类型:

EnterpriseManagementObject[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Override

指定一个哈希表,该哈希表为一个或多个任务参数定义新值(如果这些参数允许覆盖)。 有关哈希表的详细信息,请键入“Get-Help about_Hash_Tables”。

若要确定任务的哪些参数允许替代,请对任务对象使用 GetOverrideableParameters 方法。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:4
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Task

指定要启动的任务对象。 指定表示任务的变量,或使用 cmdlet(如获取任务的 Get-SCOMTask cmdlet)。 此参数仅接受一个任务对象。

参数属性

类型:ManagementPackTask
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:2
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TaskCredentials

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

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

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

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:3
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters