Get-SCOMTask

获取任务列表。

语法

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 cmdlet 获取任务列表。 使用此 cmdlet 可获取具有特定名称或 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 cmdlet 根据显示名称获取管理包,并将其传递给 Get-SCOMTask cmdlet。 由于该命令为 ErrorAction 参数指定 SilentlyContinue,因此如果 cmdlet 找到没有关联任务的管理包,则它将继续运行,并且不显示错误消息。

示例 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

指定计算机的名称数组。 该 cmdlet 与这些计算机的管理组建立临时连接。 可以使用 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

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

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

如果未指定此参数,则默认为当前用户的帐户。

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

-DisplayName

指定任务对象的显示名称数组。 此参数采用一个或多个字符串,cmdlet 在 cmdlet 使用的任务对象的显示名称之间查找匹配项。 此参数的值因将本地化管理包导入管理组以及运行Windows PowerShell的用户的区域设置而异。

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

-Id

指定任务 ID 数组。 该 cmdlet 获取具有这些 ID 的任务。 若要获取任务,请使用 Get-SCOMTask cmdlet。 ID 是任务对象的 ID 属性。

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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:True
Accept wildcard characters:False

-ManagementPack

指定管理包对象的数组。 该 cmdlet 获取数组中管理包对象的任务。 指定包含管理包对象的变量,或使用获取管理包对象的 cmdlet(例如 Get-SCOMManagementPack )。

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

-Name

指定任务名称数组。

该 cmdlet 采用数组中的每个字符串,并将其与此 cmdlet 使用的任务对象的 Name 属性匹配。

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

-SCSession

指定 Connection 对象的数组。 若要获取 Connection 对象,请指定 Get-SCOMManagementGroupConnection cmdlet。

如果未显示此参数,则 cmdlet 将使用与管理组的活动持久连接。 使用 SCSession 参数指定不同的持久连接。 可以使用 ComputerNameCredential 参数创建与管理组的临时连接。 有关详细信息,请键入“Get-Help about_OpsMgr_Connections”。

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

-Target

指定表示目标类的管理包类对象的数组。 指定包含目标类对象的变量,或使用获取目标类对象的 cmdlet(如 Get-SCOMClass )。

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