ConsoleTask

Article
01/07/2013

Applies To: System Center Service Manager 2010

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Represents a console task definition.

Schema Hierarchy

ManagementPack
  Presentation
    ConsoleTasks
      ConsoleTask

Syntax

<ConsoleTask ID=”ConsoleTaskID” Comment=”Comment” Accessibility=”Public/Internal” Enabled=”True/False” Target=”TargetID” RequireOutput=”True/False”>   <Criteria>Xpath</Criteria>
   <Assembly>assembly resource ID</Assembly>
   <Handler>handler</Handler>
   <Parameters>…</Parameters>
</ConsoleTask>

Attributes and Elements

The following sections describe attributes, child elements, and the parent element of the ConsoleTask element.

Attributes

Attribute	Description
ID	Required attribute. Represents the identity of the element. To learn how to identify your element in a management pack, see Element Identity and Namespace Conventions.
Comment	Optional attribute. Represents commentary by the management pack author.
Enabled	Required attribute. Defines whether or not this console task is by default enabled or disabled.
Target	Required attribute. The ID of the targeted entity type.
RequireOutput	Required attribute. Signifies whether or not the application should write to standard output.

RequireOutput Attribute Values

Value	Description
True	The application is expected to write to standard output.
False	The application is not expected to write to standard output.

Accessibility Attribute Values

Value	Description
Public	Indicates that the module type definition is visible to external management packs.
Internal	Indicates that the module type definition is not visible to external management packs.

Child Elements

Element	Description
Criteria	Optional element. An XPath expression that allows for restrictions on when the console task is available.
Assembly	Required element. Refers to the ID of an assembly resource that contains the specified handler for a console task.
Handler	Required element. Refers to the handler that is to be called from inside the specified assembly resource.
Parameters	Optional element. Contains the arguments to be passed to the handler.

Parent Elements

Element	Description
[ConsoleTasks](https://review.docs.microsoft.com/en-us/previous-versions/system-center/developer/hh964914(v=msdn.10))	Contains console task definitions in a management pack.

Remarks

A console task runs on the computer that is hosting the Service Manager console. Its target can be any element that the user can focus on from within the console, such as a folder or a view. In addition to specifying a target, you can specify criteria that allow the console task to target element instances that have specific attribute or element values. The criteria element value is an XPath expression over the serialized representation of the targeted class type.

Example

The following sample XML sample shows a console task that launches the help file for Service Manager Administration. Because the task is targeted at the Administration folder, it will be available in the user interface only when the user clicks on that folder.

<ConsoleTask ID="ConsoleTask.HelpAdministration" Accessibility="Public" Enabled="true" Target="Administration!Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.Folder" RequireOutput="true">
  <Assembly>SMConsole!SdkDataAccessAssembly</Assembly>
  <Handler>Microsoft.EnterpriseManagement.UI.SdkDataAccess.HelpTaskHandler</Handler>
  <Parameters>
    <Argument Name="Command">OpenCHM</Argument>
    <Argument Name="Topic">html/80cecd71-e698-43ec-938d-851c387445af.htm</Argument>
  </Parameters>
</ConsoleTask>

The following sample XML shows a console task that specifies a target class type and also supplies criteria for the targeted class. This console task will be available only when the Value attribute of the Enabled element is set to true.

<ConsoleTask ID="Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.Task.DisableADConnector" Target="ADConnector!System.LinkingFramework.ActiveDirectorySource" Accessibility="Public" RequireOutput="false">
  <Criteria>/Microsoft.SystemCenter.Connector/Enabled/@Value='True'</Criteria>
  <Assembly>Console!SdkDataAccessAssembly</Assembly>
  <Handler>Microsoft.EnterpriseManagement.UI.SdkDataAccess.ConsoleTaskHandler</Handler>
  <Parameters>
    <Argument Name="Assembly">Microsoft.EnterpriseManagement.ServiceManager.UI.Administration</Argument>
    <Argument Name="Type">Microsoft.EnterpriseManagement.ServiceManager.UI.Administration.Connectors.Common.ConnectorTaskHandler</Argument>
    <Argument>Disable</Argument>
  </Parameters>
</ConsoleTask>

The serialized representation of the Microsoft.SystemCenter.Connector class type appears in the following manner:

<Microsoft.SystemCenter.Connector Id="d5c10334-535e-219d-bd53-3fb95bb64d3f" Name="27320aef-a133-498b-82cf-c505acd61f89" Path="" FullName="Microsoft.SystemCenter.Connector:27320aef-a133-498b-82cf-c505acd61f89" DisplayName="AD " LastModified="4/29/2010 9:51:14 PM" Role="" RelationshipType="">
  <Id Value="27320aef-a133-498b-82cf-c505acd61f89" Class="Microsoft.SystemCenter.Connector" SystemType="System.String" Type="string"></Id>
  <Name Value="ADConnector.5f845844d3ea453eaa9f7bb032c60a69" Class="Microsoft.SystemCenter.Connector" SystemType="System.String" Type="string"></Name>
  <Description Value="" Class="Microsoft.SystemCenter.Connector" SystemType="System.String" Type="string"></Description>
  <DiscoveryDataIsManaged Value="" Class="Microsoft.SystemCenter.Connector" SystemType="System.Boolean" Type="bool"></DiscoveryDataIsManaged>
  <DiscoveryDataIsShared Value="" Class="Microsoft.SystemCenter.Connector" SystemType="System.Boolean" Type="bool"></DiscoveryDataIsShared>
  <FQDN Value="redmond.corp.microsoft.com" Class="System.LinkingFramework.ActiveDirectorySource" SystemType="System.String" Type="string"></FQDN>
  <UserList Value="" Class="System.LinkingFramework.ActiveDirectorySource" SystemType="System.String" Type="string"></UserList>
  <PrinterList Value="" Class="System.LinkingFramework.ActiveDirectorySource" SystemType="System.String" Type="string"></PrinterList>
  <ComputerList Value="" Class="System.LinkingFramework.ActiveDirectorySource" SystemType="System.String" Type="string"></ComputerList>
  <GroupList Value="fa9619141a396144b7cc144667adf811,Exchange 2010 - Corp Org Admins" Class="System.LinkingFramework.ActiveDirectorySource" SystemType="System.String" Type="string"></GroupList>
  <SolutionName Value="" Class="System.LinkingFramework.DataSource" SystemType="System.String" Type="string"></SolutionName>
  <DataProviderName Value="ADConnector" Class="System.LinkingFramework.DataSource" SystemType="System.String" Type="string"></DataProviderName>
  <DataProviderDisplayName Value="Active Directory" Class="System.LinkingFramework.DataSource" SystemType="System.String" Type="string"></DataProviderDisplayName>
  <ReaderProfileName Value="Microsoft.SystemCenter.DatabaseWriteActionAccount" Class="System.LinkingFramework.DataSource" SystemType="System.String" Type="string"></ReaderProfileName>
  <DatawarehouseProfileName Value="" Class="System.LinkingFramework.DataSource" SystemType="System.String" Type="string"></DatawarehouseProfileName>
  <Reserved Value="" Class="System.LinkingFramework.DataSource" SystemType="System.String" Type="string"></Reserved>
  <ImpersonationEnabled Value="True" Class="System.LinkingFramework.DataSource" SystemType="System.Boolean" Type="bool"></ImpersonationEnabled>
  <SyncType Value="SyncTypeEnum.Hours" Class="System.LinkingFramework.DataSource" SystemType="System.Enum" Type="enum"></SyncType>
  <SyncInterval Value="1" Class="System.LinkingFramework.DataSource" SystemType="System.Int32" Type="int"></SyncInterval>
  <SyncTime Value="4/29/2010 9:50:20 PM" Class="System.LinkingFramework.DataSource" SystemType="System.DateTime" Type="datetime"></SyncTime>
  <SyncNow Value="True" Class="System.LinkingFramework.DataSource" SystemType="System.Boolean" Type="bool"></SyncNow>
  <Enabled Value="False" Class="System.LinkingFramework.DataSource" SystemType="System.Boolean" Type="bool"></Enabled>
  <DisplayName Value="AD " Class="System.Entity" SystemType="System.String" Type="string"></DisplayName>
  <Microsoft.SystemCenter.LinkingFramework.SyncStatus Id="f620a977-7091-71de-8c25-a20d2f2d409c" Name="" Path="27320aef-a133-498b-82cf-c505acd61f89" FullName="Microsoft.SystemCenter.LinkingFramework.SyncStatus:27320aef-a133-498b-82cf-c505acd61f89" DisplayName="Microsoft.SystemCenter.LinkingFramework.SyncStatus" LastModified="4/29/2010 9:51:14 PM" Role="SyncStatus" RelationshipType="Microsoft.SystemCenter.LinkingFramework.DataSourceHostSyncStatus">
    <LastRunStartTime Value="" Class="Microsoft.SystemCenter.LinkingFramework.SyncStatus" SystemType="System.DateTime" Type="datetime"></LastRunStartTime>
    <LastRunFinishTime Value="" Class="Microsoft.SystemCenter.LinkingFramework.SyncStatus" SystemType="System.DateTime" Type="datetime"></LastRunFinishTime>
    <Status Value="Microsoft.SystemCenter.LinkingFramework.SyncStatusEnum.NeverRun" Class="Microsoft.SystemCenter.LinkingFramework.SyncStatus" SystemType="System.Enum" Type="enum"></Status>
    <SyncPercent Value="0" Class="Microsoft.SystemCenter.LinkingFramework.SyncStatus" SystemType="System.Int32" Type="int"></SyncPercent>
    <MaxValue Value="100" Class="Microsoft.SystemCenter.LinkingFramework.SyncStatus" SystemType="System.Int32" Type="int"></MaxValue>
    <MinValue Value="0" Class="Microsoft.SystemCenter.LinkingFramework.SyncStatus" SystemType="System.Int32" Type="int"></MinValue>
    <DisplayName Value="Microsoft.SystemCenter.LinkingFramework.SyncStatus" Class="System.Entity" SystemType="System.String" Type="string"></DisplayName>
    <Id Value="27320aef-a133-498b-82cf-c505acd61f89" Class="Microsoft.SystemCenter.Connector" SystemType="System.String" Type="string"></Id>
  </Microsoft.SystemCenter.LinkingFramework.SyncStatus>
</Microsoft.SystemCenter.Connector>

Partager via