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。