Reference (Manifest)

Article
05/16/2012

Applies To: Operations Manager 2007 R2, System Center Operations Manager 2007

Represents an external management pack as a dependency reference in a management pack.

Schema Hierarchy

ManagementPack
  Manifest
    References (Manifest)
      Reference (Manifest)

Syntax

<Reference Alias="System">   <ID>System.Library</ID>   <Version>6.1.7221.0</Version>   <PublicKeyToken>31bf3856ad364e35</PublicKeyToken></Reference>

Attributes and Elements

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

Attributes

Attribute	Description
Alias	A short name used when referencing an element inside the referenced management pack.

Child Elements

Element	Description
ID (Identity)	Required element. Represents the ID of the referenced management pack.
Version (Reference)	Required element. Represents the version number of the referenced management pack.
PublicKeyToken (Reference)	Required element. Represents the public key token of the referenced signed and sealed management pack.

Parent Elements

Element	Description
References (Manifest)	Contains all management pack dependency references in a management pack.

Remarks

The value of Alias for each Reference element must be unique within the management pack. Also, a referenced management pack cannot be assigned to two different aliases within a single management pack.

You can reference only sealed management packs within your management pack. To do this, you must get the public key token of the sealed management pack. To learn how to get a public key token from a sealed management pack, see PublicKeyToken (Reference).

The syntax for referencing an element within an external management pack is Alias!ElementID. For an example, see the sample that follows.

The Reference element represents the strong name of the referenced management pack.

Example

The following sample illustrates how to use the Alias property to reference an element in an external management pack. A WriteAction (WriteActionModuleType) module references the System.CommandExecuterWriteActionModuleType definition. The write action module type is defined within the referenced System.Library management pack whose Alias is System.

<Manifest>
  <Identity>
    <ID>Microsoft.ManagementPack.Sample</ID>
    <Version>1.1.4.0</Version>
  </Identity>
  <Name>Management Pack Sample</Name>
  <References>
    <Reference Alias="SCDW">
      <ID>Microsoft.SystemCenter.DataWarehouse.Library</ID>
      <Version>6.0.6278.0</Version>
      <PublicKeyToken>31bf3856ad364e35</PublicKeyToken>
    </Reference>
    <Reference Alias="SC">
      <ID>Microsoft.SystemCenter.Library</ID>
      <Version>6.0.6278.0</Version>
      <PublicKeyToken>31bf3856ad364e35</PublicKeyToken>
    </Reference>
    <Reference Alias="Windows">
      <ID>Microsoft.Windows.Library</ID>
      <Version>6.0.6278.0</Version>
      <PublicKeyToken>31bf3856ad364e35</PublicKeyToken>
    </Reference>
    <Reference Alias="Health">
      <ID>System.Health.Library</ID>
      <Version>6.0.6278.0</Version>
      <PublicKeyToken>31bf3856ad364e35</PublicKeyToken>
    </Reference>
    <Reference Alias="System">
      <ID>System.Library</ID>
      <Version>6.0.6278.0</Version>
      <PublicKeyToken>31bf3856ad364e35</PublicKeyToken>
    </Reference>
    <Reference Alias="Performance">
      <ID>System.Performance.Library</ID>
      <Version>6.0.6278.0</Version>
      <PublicKeyToken>31bf3856ad364e35</PublicKeyToken>
    </Reference>
  </References>

…

  <WriteAction ID="StartService" TypeID="System!System.CommandExecuter">
     <ApplicationName><![CDATA[%WinDir%\System32\sc.exe]]></ApplicationName>
     <WorkingDirectory />
     <CommandLine>\\$Config/ComputerName$ start $Config/ServiceName$</CommandLine>
     <TimeoutSeconds>60</TimeoutSeconds>
     <RequireOutput>true</RequireOutput>
  </WriteAction>
</Manifest>