Configuración y uso de cmdlets de Service Manager para Windows PowerShell

Artículo
04/18/2024

Importante

Esta versión de Service Manager ha llegado al final del soporte técnico. Se recomienda actualizar a Service Manager 2022.

En este artículo se proporciona una introducción a los cmdlets de Service Manager para la interfaz de la línea de comandos de Windows PowerShell.

Para poder ejecutar cualquier comando en la interfaz de línea de comandos de Windows PowerShell en Service Manager, debe establecer la directiva de ejecución en RemoteSigned. Para poder ejecutar cmdlets de almacenamiento de datos, debe importar manualmente el módulo cmdlets de almacenamiento de datos.

Los cmdlets Service Manager se implementan en los dos módulos siguientes:

System.Center.Service.Manager. Este módulo se importa automáticamente cada vez que se abre una sesión de Service Manager Windows PowerShell.
Microsoft.EnterpriseManagement.Warehouse.Cmdlets. Este módulo se debe importar manualmente.

Introducción a los cmdlets de Service Manager

Windows PowerShell es un shell de línea de comandos de Windows que incluye un aviso interactivo y un entorno de scripting. Windows PowerShell usa cmdlets para manipular los objetos Windows PowerShell. Service Manager incluye muchos cmdlets que puede usar para realizar varias tareas relacionadas con Service Manager sin usar la consola de Service Manager. Por ejemplo, puede usar el cmdlet Import-SCSMManagementPack para importar un módulo de administración.

Los cmdlets de Service Manager se entregan en dos módulos que se enumeran a continuación. En Service Manager, estos módulos de cmdlet no se instalan en la ruta de acceso típica que aparece en la variable $env:PSModulePath. Por lo tanto, si ejecuta el Get-Module -List cmdlet , los módulos de Service Manager no aparecen en la lista.

Cmdlets de administrador: el módulo System.Center.Service.Manager que contiene los cmdlets necesarios para tareas administrativas comunes.
Cmdlets de almacenamiento de datos: el módulo Microsoft.EnterpriseManagement.Warehouse.Cmdlets que contiene los cmdlets necesarios para operar en el almacenamiento de datos de Service Manager.

Los cmdlets de almacenamiento de datos funcionan en la base de datos de almacenamiento de datos y puede ejecutarlos tanto en el servidor de administración de Service Manager como en el servidor de administración del almacenamiento de datos.

Los datos que devuelve el comando de Windows PowerShell pueden contener más información de la que se puede mostrar en una ventana predeterminada de comandos Windows PowerShell. Se recomienda aumentar el ancho de la ventana de comandos: haga clic con el botón derecho en la barra de título, seleccione Propiedades y, en la pestaña Diseño , establezca el ancho tamaño del búfer de pantalla en 120.

Los procedimientos siguientes le ayudarán a empezar a trabajar con cmdlets de Service Manager.

Para abrir una sesión de Service Manager Windows PowerShell desde la consola de Service Manager

En la consola de Service Manager, seleccione Administración.
En el panel Tareas , seleccione Iniciar sesión de PowerShell.

El módulo del cmdlet de administrador se importa previamente automáticamente en esta sesión.

Para abrir una sesión de Service Manager Windows PowerShell desde Windows

En el equipo que hospeda el servidor de administración de Service Manager, en la barra de tareas, seleccione Inicio, seleccione Todos los programas y Seleccione Microsoft System Center.
Seleccione Service Manager <versión> y Service Manager Shell.

El módulo del cmdlet de administrador se importa previamente automáticamente en esta sesión.

Para enumerar todos los cmdlets de Service Manager

Abra una sesión de Service Manager Windows PowerShell.
Para enumerar los cmdlets que se incluyen en el módulo de administrador, en la sesión de Service Manager Windows PowerShell, escriba lo siguiente y presione ENTRAR:
```
Get-Command -module System.Center.Service.Manager
```
Para enumerar los cmdlets que se incluyen en el módulo de almacenamiento de datos, en la sesión de Service Manager Windows PowerShell, escriba lo siguiente y presione ENTRAR:
```
Get-Command -module Microsoft.EnterpriseManagement.Warehouse.Cmdlets
```

Para obtener ayuda sobre un cmdlet

Abra una sesión de Service Manager Windows PowerShell.
Ahora puede acceder a la Ayuda integrada, o bien puede usar el -online parámetro para acceder a la Ayuda en línea más actualizada:
- Ayuda integrada: escriba el siguiente comando. Reemplace cmdlet-name por el nombre del cmdlet para el que desea obtener ayuda, por ejemplo, Import-SCSMManagementPack:
```
Get-help <cmdlet-name> -detailed
```
- Ayuda en línea y actualizada: escriba el siguiente comando y presione ENTRAR:
```
Get-help <cmdlet-name> -online
```
  Este comando usa el -online parámetro para acceder a la ayuda en línea más reciente de un cmdlet. Abre un explorador web y muestra la Ayuda en línea que está disponible para el nombre del cmdlet.

Lista de los cmdlets de Service Manager

Service Manager admite los siguientes cmdlets de Windows PowerShell, que se implementan en dos módulos: el módulo de administrador y el módulo de almacenamiento de datos.

Cmdlets de administrador en el módulo System.Center.Service.Manager

Cmdlet	Descripción
Add-SCSMAllowListClass	Agrega las clases especificadas a la lista Permitir de clases que usa el conector de CI de Service Manager Operations Manager durante la sincronización.
Export-SCSMManagementPack	Exporta un módulo de administración como un archivo con formato XML válido que puede importar posteriormente en Service Manager o Operations Manager.
Get-SCSMAllowList	Recupera la lista De permitidos de clases que usa el conector de CI de Service Manager Operations Manager durante la sincronización.
Get-SCSMAnnouncement	Recupera los anuncios que se definen en Service Manager.
Get-SCSMChannel	Recupera los canales de notificación por correo electrónico que se definen en Service Manager.
Get-SCSMClass	Recupera una clase.
Get-SCSMClassInstance	Recupera objetos de instancia de clase.
Get-SCSMCommand
Get-SCSMConnector	Recupera los conectores que se definen en Service Manager.
Get-SCSMDCMWorkflow	Recupera la lista de flujos de trabajo de administración de configuración deseados definidos en Service Manager.
Get-SCSMDeletedItem	Recupera los elementos que se han marcado para su eliminación en Service Manager.
Get-SCSMDiscovery	Recupera información de detección de Operations Manager y de Service Manager.
Get-SCSMEmailTemplate	Recupera las plantillas de correo electrónico que se definen en Service Manager.
Get-SCSMEmailTemplateContent	Recupera el contenido de las plantillas de correo electrónico de Service Manager.
Get-SCSMGroup	Recupera grupos de Operations Manager y de Service Manager.
Get-SCSMManagementGroupConnection	Recupera todas las conexiones de grupo de administración, incluido el estado IsActive de estas conexiones. Solo una conexión tendrá su conjunto de estado IsActive en True, ya que solo una conexión puede estar activa en todo momento.
Get-SCSMManagementPack	Recupera objetos que representan módulos de administración que se han importado.
Get-SCSMObjectTemplate	Recupera un plantilla de objeto.
Get-SCSMQueue	Recupera las colas que se definen en Service Manager.
Get-SCSMRelationship	Recupera información sobre los objetos de relación de Operations Manager y de Service Manager.
Get-SCSMRelationshipInstance	Recupera las instancias de relaciones de Operations Manager y de Service Manager.
Get-SCSMRunAsAccount	Recupera cuentas de ejecución.
Get-SCSMSetting	Recupera los valores de configuración de System Center Service Manager.
Get-SCSMSubscription	Recupera las suscripciones que se configuran en Service Manager.
Get-SCSMTask	Recupera las tareas que se definen en Service Manager.
Get-SCSMUser	Recupera los usuarios que se definen en Service Manager.
Get-SCSMUserRole	Recupera las funciones de usuario que se definen en Service Manager.
Get-SCSMView	Recupera las vistas que se definen en Service Manager.
Get-SCSMWorkflow	Recupera la información de configuración de flujos de trabajo de Service Manager.
Get-SCSMWorkflowStatus	Recupera el estado de flujos de trabajo en Service Manager.
Import-SCSMInstance	Importa objetos y relaciones de un archivo de valores separados por comas (.csv) en Service Manager.
Import-SCSMManagementPack	Importa los módulos de administración.
New-SCOrchestratorConnector	Crea un nuevo conector de Orchestrator de Service Manager.
New-SCRelationshipInstance	Crea una instancia de una relación.
New-SCSMADConnector	Crea un nuevo conector de Active Directory.
New-SCSMAlertRule	Crea una regla de alerta que se usará con un conector de alertas de Operations Manager en Service Manager.
New-SCSMAnnouncement	Crea un nuevo anuncio en Service Manager.
New-SCSMClassInstance	Agrega una instancia de la clase a la base de datos.
New-SCSMCMConnector	Crea un nuevo conector de Configuration Manager en Service Manager.
New-SCSMDCMWorkflow	Crea un nuevo flujo de trabajo de administración de configuración deseado en Service Manager.
New-SCSMEmailTemplate	Crea una nueva plantilla de correo electrónico para Service Manager.
New-SCSMManagementGroupConnection	Crea una nueva conexión para el grupo de administración especificado. La conexión de grupo de administración más reciente que se creó es la conexión activa que usan los cmdlets Get- de forma predeterminada, en las que no especificó los parámetros ComputerName y Credential, o scSession .
New-SCSMManagementPack	Crea un nuevo módulo de administración.
New-SCSMManagementPackBundle	Reúne los módulos de administración individuales y sus recursos, creando un nuevo paquete de administración.
New-SCSMOMAlertConnector	Crea un nuevo conector de alertas de Operations Manager en Service Manager.
New-SCSMOMConfigurationItemConnector	Crea un nuevo conector de elementos de configuración de Operations Manager en Service Manager.
New-SCSMRunAsAccount	Crea una nueva cuenta de ejecución.
New-SCSMSubscription	Crea una nueva suscripción en Service Manager.
New-SCSMUserRole	Crea un nuevo rol de usuario en Service Manager.
New-SCSMWorkflow	Crea un nuevo flujo de trabajo en Service Manager.
New-SCVMMConnector	Crea un nuevo conector de Virtual Machine Manager de Service Manager.
Protect-SCSMManagementPack	Sella un módulo de administración, lo que impide que se modifique.
Remove-SCSMAllowListClass	Quita las clases especificadas de la lista Permitir de clases que usa operations Manager CI Connector durante la sincronización en Service Manager.
Remove-SCSMAnnouncement	Quita un anuncio de Service Manager.
Remove-SCSMClassInstance	Quita una instancia de un objeto de elemento de configuración.
Remove-SCSMConnector	Quita un conector de Service Manager.
Remove-SCSMDCMWorkflow	Quita un flujo de trabajo de administración de configuración deseado de Service Manager.
Remove-SCSMEmailTemplate	Quita una plantilla de correo electrónico de Service Manager.
Remove-SCSMManagementGroupConnection	Quita una conexión del grupo de administración.
Remove-SCSMManagementPack	Quita los módulos de administración.
Remove-SCSMRunAsAccount	Quita una cuenta de ejecución.
Remove-SCSMSubscription	Quita una suscripción de Service Manager.
Remove-SCSMUserRole	Quita un rol de usuario de Service Manager.
Remove-SCSMWorkflow	Quita un flujo de trabajo de Service Manager.
Reset-SCSMAllowList	Restablece la lista De permitidos de las clases que usa operations Manager CI Connector en Service Manager a la lista de permitidos predeterminada.
Restore-SCSMDeletedItem	Restaura los elementos que se eliminaron anteriormente en Service Manager.
Set-SCSMChannel	Establece las propiedades del canal de notificación de correo electrónico en Service Manager.
Set-SCSMManagementGroupConnection	Establece la conexión especificada como la conexión activa. La conexión activa es la conexión que se usa implícitamente al ejecutar un cmdlet Get- sin especificar parámetros -ComputerName y -Credential o -SCSession . Solo se puede activar una conexión en cualquier momento y, de forma predeterminada, la conexión activa es la última conexión que se creó mediante el cmdlet New-SCManagementGroupConnection .
Start-SCSMConnector	Inicia un conector de Service Manager.
Test-SCSMManagementPack	Comprueba la validez de un módulo de administración.
Update-SCSMAnnouncement	Actualiza las propiedades de un anuncio de Service Manager.
Update-SCSMClassInstance	Novedades valores de propiedad de una instancia de clase de elemento de configuración.
Update-SCSMConnector	Novedades propiedades de un conector de Service Manager.
Update-SCSMDCMWorkflow	Novedades propiedades de un flujo de trabajo de administración de configuración deseado.
Update-SCSMEmailTemplate	Actualiza las propiedades de una plantilla de correo electrónico.
Update-SCSMRunAsAccount	Novedades las credenciales asociadas a una cuenta de ejecución.
Update-SCSMSetting	Actualiza los valores de configuración de Service Manager.
Update-SCSMSubscription	Actualiza las propiedades de suscripción en Service Manager.
Update-SCSMUserRole	Establece la propiedad UserRole para un usuario de Service Manager.
Update-SCSMWorkflow	Actualiza las propiedades de flujo de trabajo.

Data Warehouse cmdlets en el módulo Microsoft.EnterpriseManagement.Warehouse.Cmdlets

Cmdlet	Descripción
Disable-SCDWJob	Deshabilita un trabajo del almacenamiento de datos para impedir que se ejecute.
Disable-SCDWJobSchedule	El cmdlet Disable-SCDWJobSchedule deshabilita una programación de trabajo de Data Warehouse, lo que hace que la programación del trabajo deje de iniciar trabajos. Si la programación de trabajos se habilitó anteriormente, al deshabilitar la programación de trabajos se mantiene la configuración de la programación de trabajos. Para modificar la configuración de programación del trabajo, ejecute el cmdlet Set-SCDWJobSchedule .
Disable-SCDWSource	Habilita todos los trabajos que están afiliados al origen de datos especificado.
Enable-SCDWJob	Habilita un trabajo de almacenamiento de datos de modo que se pueda ejecutar según la programación.
Enable-SCDWJobSchedule	El cmdlet Enable-SCDWJobSchedule permite a los administradores de Data Warehouse habilitar las programaciones de trabajo para que los trabajos se ejecuten según su programación especificada. Para deshabilitar la programación del trabajo, use el cmdlet Disable-SCDWJobSchedule .
Enable-SCDWSource	Habilita todos los trabajos que están afiliados al origen de datos especificado.
Get-SCDWEntity	Obtiene la lista de tablas de hechos, dimensiones, tablas y registradores que existen en un almacenamiento de datos.
Get-SCDWJob	Obtiene el estado del trabajo de todos los trabajos periódicos, incluidos los trabajos de extracción, transformación y carga (ETL).
Get-SCDWJobModule	Devuelve información detallada del trabajo especificado. Esta información incluye los módulos del trabajo que se ejecutan como parte del trabajo.
Get-SCDWJobSchedule	El cmdlet Get-SCDWJobSchedule muestra información de programación para los trabajos de Data Warehouse. Puede usar el parámetro JobName para especificar un trabajo para el que mostrar información de programación. De lo contrario, el cmdlet Get-SCDWJobSchedule muestra información de programación para todos los trabajos de Data Warehouse.
Get-SCDWModule
Get-SCDWRetentionPeriod	El Data Warehouse limpia las filas después de un período de retención predefinido. Este cmdlet proporciona el período de retención para una entidad determinada en minutos. Si no se proporciona ninguna entidad, devuelve el período de retención predeterminado para todas las entidades.
Get-SCDWSource	Habilita todos los trabajos que están afiliados al origen de datos especificado.
Get-SCDWSourceType	Obtiene los tipos de orígenes de datos que se pueden registrar en el almacenamiento de datos.
Get-SCDWWatermark	Obtiene la marca de agua más reciente del módulo de trabajo especificado.
New-SCDWSourceType	Para registrar un origen con el Data Warehouse, el tipo de origen de datos primero debe registrarse con el Data Warehouse. Este cmdlet ayuda a registrar un nuevo tipo de origen de datos importando el módulo de administración adecuado y realizando los cambios de configuración adecuados.
Register-SCDWSource	Registra instancias de tipos de origen de datos, como Service Manager, Operations Manager y Configuration Manager, en el almacenamiento de datos.
Set-SCDWJobSchedule	Establece la programación de un trabajo de almacenamiento de datos.
Set-SCDWRetentionPeriod	Establece el período de retención de datos en minutos para una tabla de hechos específica dentro de una base de datos de almacenamiento de datos específica o establece el valor predeterminado para las tablas de hechos dentro de la base de datos.
Set-SCDWSource	Novedades la definición de clases y relaciones que se pueden rellenar para una instancia de un origen de datos.
Set-SCDWWatermark	- Establece la marca de agua desde la que debe continuar el procesamiento de datos posterior.
Start-SCDWJob	Inicia un trabajo de almacenamiento de datos.
Unregister-SCDWManagememtPack
Unregister-SCDWSource	Anula el registro de un origen de datos del almacenamiento de datos.

Pasos siguientes

Para realizar tareas de mantenimiento en trabajos de almacenamiento de datos, consulte Administración del almacenamiento de datos.