Configure Windows PowerShell to run in Service Manager

Article
03/18/2024

Important

This version of Service Manager has reached the end of support. We recommend you to upgrade to Service Manager 2022.

Before you can run commands in the Windows PowerShell command-line interface in System Center - Service Manager, you must set execution policy to RemoteSigned and import the data warehouse cmdlet module.

The Service Manager cmdlets are implemented in the following two modules:

System.Center.Service.Manager. This module is imported automatically every time a Service Manager Windows PowerShell session is opened.
Microsoft.EnterpriseManagement.Warehouse.Cmdlets. This module must be imported manually.

Cmdlets in Authoring Tool workflows

When you use the Service Manager Authoring tool to create a workflow, then custom scripts using Windows PowerShell cmdlets called by the workflow fail. This is due to a problem in the Service Manager MonitoringHost.exe.config file.

To work around this problem, update the MonitoringHost.exe.config XML file using the following steps.

Navigate to %ProgramFiles%\Microsoft System Center\Service Manager or the location where you installed Service Manager.
Edit the MonitoringHost.exe.config file and add the section in italic type from the example below in the corresponding section of your file. You must insert the section before <publisherPolicy apply="yes" />.
Save your changes to the file.
Restart the System Center Management service on the Service Manager management server.

<?xml version="1.0"?>
<configuration>
    <configSections>
        <section name="uri" type="System.Configuration.UriSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
    </configSections>
    <uri>
        <iriParsing enabled="true" />
    </uri>
    <runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
            <dependentAssembly>
                <assemblyIdentity name="Microsoft.Mom.Modules.DataTypes" publicKeyToken="31bf3856ad364e35" />
                <publisherPolicy apply="no" />
                <bindingRedirect oldVersion="6.0.4900.0" newVersion="7.0.5000.0" />
            </dependentAssembly>
            <dependentAssembly>
                <assemblyIdentity name="Microsoft.EnterpriseManagement.HealthService.Modules.WorkflowFoundation" publicKeyToken="31bf3856ad364e35" />
                <publisherPolicy apply="no" />
                <bindingRedirect oldVersion="6.0.4900.0" newVersion="7.0.5000.0" />
            </dependentAssembly>
            <dependentAssembly>
                <assemblyIdentity name="Microsoft.EnterpriseManagement.Modules.PowerShell" publicKeyToken="31bf3856ad364e35" />
                <bindingRedirect oldVersion="6.0.4900.0" newVersion="7.0.5000.0" />
            </dependentAssembly>
            <publisherPolicy apply="yes" />
            <probing privatePath="" />
        </assemblyBinding>
        <gcConcurrent enabled="true" />
    </runtime>
</configuration>

Execution policy

Use the following procedure to set execution policy to RemoteSigned in Service Manager. This is necessary to enable the importation of the Service Manager cmdlet modules, automatically or manually.

You have to run this command only once on the computer where you intend to use Windows PowerShell cmdlets for Service Manager.

To set execution policy

On the computer where you want to run Windows PowerShell, select Start, select All Programs, select Microsoft System Center <version>, select Service Manager, and select Service Manager Shell.
At the Windows PowerShell prompt, enter the following command, and then press ENTER:
```
Set-ExecutionPolicy –Force RemoteSigned
```
Enter exit, and then press ENTER to close the Administrator: Windows PowerShell window.

Import the data warehouse cmdlet module

To be able to use the data warehouse cmdlets in Service Manager, you must first manually import the Windows PowerShell data warehouse cmdlets module for Service Manager. You can import the data warehouse cmdlets module on the Service Manager management server, the data warehouse management server, or both.

To import the data warehouse cmdlets module

On a management server, open a Service Manager Windows PowerShell session. Or on a data warehouse management server, open a Windows PowerShell session. Ensure that the Windows PowerShell prompt is at the Service Manager installation folder.
At the Windows PowerShell command prompt, enter the following command, and then press ENTER:
```
Import-Module ".Microsoft.EnterpriseManagement.Warehouse.Cmdlets.psd1"
```
Enter exit, and then press ENTER to close the Administrator: Windows PowerShell window.

Next steps

To run the Data Warehouse Registration Wizard to register the Service Manager management group with the Service Manager data warehouse management server, review Register with the data warehouse to enable reporting. Registering with the data warehouse makes it possible for you to run reports.