Compartir a través de


Configurar y usar cmdlets de Service Manager para Windows PowerShell

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 la línea de comandos de Windows PowerShell en Service Manager, debes establecer la directiva de ejecución en RemoteSigned. Para poder ejecutar cmdlets de almacenamiento de datos, debes importar manualmente el módulo de cmdlets de almacenamiento de datos.

Los cmdlets de 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 Windows PowerShell de Service Manager.

  • 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 que incluye una solicitud interactiva y un entorno de scripting. Windows PowerShell usa cmdlets para manipular los objetos de Windows PowerShell. Service Manager incluye muchos cmdlets que puedes usar para realizar diversas tareas relacionadas con Service Manager sin usar la consola de Service Manager. Por ejemplo, puedes 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 ejecutas el cmdlet Get-Module -List, 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 puedes ejecutarlos tanto en el servidor de administración de Service Manager como en el servidor de administración del almacenamiento de datos.

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

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

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

  1. En la consola de Service Manager, haz clic en Administración.

  2. En el panel Tareas, selecciona Iniciar sesión de PowerShell.

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

Abrir una sesión de Windows PowerShell de Service Manager desde Windows

  1. En el equipo que hospeda el servidor de administración de Service Manager, en la barra de tareas, selecciona Inicio, apunta a Todos los programas y selecciona Microsoft System Center.

  2. Selecciona Service Manager <versión> y selecciona shelll de Service Manager.

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

Enumeración de todos los cmdlets de Service Manager

  1. Abre una sesión de Windows PowerShell de Service Manager.

  2. Para enumerar los cmdlets que se incluyen en el módulo de administrador, en la sesión de Windows PowerShell de Service Manager, escribe lo siguiente y presiona ENTRAR:

    Get-Command -module System.Center.Service.Manager
    
  3. Para enumerar los cmdlets que se incluyen en el módulo de almacenamiento de datos, en la sesión de Windows PowerShell de Service Manager, escribe lo siguiente y luego presiona ENTRAR:

    Get-Command -module Microsoft.EnterpriseManagement.Warehouse.Cmdlets
    

Obtener ayuda para un cmdlet

  1. Abre una sesión de Windows PowerShell de Service Manager.

  2. Ahora puedes acceder a la Ayuda en pantalla o puedes usar el parámetro -online para acceder a la Ayuda en pantalla más actualizada:

    • En la Ayuda en pantalla, escribe el siguiente comando. Reemplaza cmdlet-name por el nombre del cmdlet para el que quieras obtener ayuda, por ejemplo, Import-SCSMManagementPack:

      Get-help <cmdlet-name> -detailed
      
    • Ayuda en línea actualizada: escribe el siguiente comando y presiona ENTRAR:

      Get-help <cmdlet-name> -online
      

      Este comando usa el parámetro -online para acceder a la ayuda en pantalla más reciente de un cmdlet. Abre un explorador web y muestra la ayuda en pantalla que está disponible para cmdlet-name.

Lista de 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 de permitidos de clases que usa el conector de CI para Operations Manager de Service Manager durante la sincronización.
Export-SCSMManagementPack Exporta un módulo de administración como archivo con formato XML válido que se puede importar posteriormente en Service Manager u Operations Manager.
Get-SCSMAllowList Recupera la Lista de permitidos de las clases que usa el conector de CI para Operations Manager de Service Manager durante la sincronización.
Get-SCSMAnnouncement Recupera anuncios definidos en Service Manager.
Get-SCSMChannel Recupera los canales de notificación por correo electrónico definidos en Service Manager.
Get-SCSMClass Recupera una tarea.
Get-SCSMClassInstance Recupera objetos de instancia de clase.
Get-SCSMCommand
Get-SCSMConnector Recupera conectores que están definidos 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 marcados para eliminación en Service Manager.
Get-SCSMDiscovery Recupera información de detección de Operations Manager y Service Manager.
Get-SCSMEmailTemplate Recupera plantillas de correo electrónico definidas 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 del grupo de administración, incluido el estado IsActive de estas conexiones. Solo una conexión tendrá el estado IsActive establecido en True, ya que solo una conexión puede estar activa en cualquier momento.
Get-SCSMManagementPack Recupera objetos que representan módulos de administración que se han importado.
Get-SCSMObjectTemplate Recupera una plantilla de objeto.
Get-SCSMQueue Recupera las colas definidas en Service Manager.
Get-SCSMRelationship Recupera información sobre los objetos de relación de Operations Manager y Service Manager.
Get-SCSMRelationshipInstance Recupera las instancias de relaciones de Operations Manager y Service Manager.
Get-SCSMRunAsAccount Recupera Cuentas de ejecución.
Get-SCSMSetting Recupera las opciones de configuración de System Center Service Manager.
Get-SCSMSubscription Recupera las suscripciones configuradas en Service Manager.
Get-SCSMTask Recupera las tareas definidas en Service Manager.
Get-SCSMUser Recupera los usuarios definidos en Service Manager.
Get-SCSMUserRole Recupera los roles de usuario definidos en Service Manager.
Get-SCSMView Recupera las vistas definidas en Service Manager.
Get-SCSMWorkflow Recupera la información de configuración de los flujos de trabajo de Service Manager.
Get-SCSMWorkflowStatus Recupera el estado de los 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 módulos de administración.
New-SCOrchestratorConnector Crea un nuevo conector de Service Manager Orchestrator.
New-SCRelationshipInstance Crea una instancia de una relación.
New-SCSMADConnector Permite crear un nuevo grupo 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 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 del grupo de administración creada más recientemente es la conexión activa que usan los cmdlets Get- de forma predeterminada, en la que no especificaste los parámetros ComputerName y Credential, o SCSession.
New-SCSMManagementPack Crea un nuevo módulo de administración.
New-SCSMManagementPackBundle Agrupa módulos de administración individuales y sus recursos, lo que genera un nuevo paquete de módulos de administración.
New-SCSMOMAlertConnector Crea un nuevo conector de alertas de Operations Manager en Service Manager.
New-SCSMOMConfigurationItemConnector Crea un nuevo conector de CI 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 Service Manager Virtual Machine Manager.
Protect-SCSMManagementPack Sella un módulo de administración e impide que se modifique.
Remove-SCSMAllowListClass Quita las clases especificadas de la Lista de permitidos de clases que usa el conector de CI de Operations Manager 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 de 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 el conector de CI de Operations Manager 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 los parámetros -ComputerName y -Credential, o -SCSession. Solo puede haber una conexión activa en cualquier momento. 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 para Service Manager.
Update-SCSMClassInstance Actualiza los valores de propiedad de una instancia de clase de elemento de configuración.
Update-SCSMConnector Actualiza las propiedades de un conector de Service Manager.
Update-SCSMDCMWorkflow Actualiza las 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 Actualiza las credenciales asociadas a una cuenta de ejecución.
Update-SCSMSetting Actualiza las opciones de configuración de Service Manager.
Update-SCSMSubscription Actualiza las propiedades de la suscripción en Service Manager.
Update-SCSMUserRole Establece la propiedad UserRole para un usuario de Service Manager.
Update-SCSMWorkflow Actualiza las propiedades del flujo de trabajo.

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

Cmdlet Descripción
Disable-SCDWJob Deshabilita un trabajo de almacenamiento de datos para evitar que se ejecute.
Disable-SCDWJobSchedule El cmdlet Disable-SCDWJobSchedule deshabilita una programación de trabajos de Data Warehouse, lo que hace que el programa del trabajo deje de iniciar trabajos. Si el programa de trabajos se ha habilitado anteriormente, deshabilitar el programa de trabajos conserva la configuración del programa de trabajos. Para modificar la configuración del programa de trabajo, ejecuta 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 Data Warehouse para que pueda ejecutarse según su 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 el programa de trabajos, usa 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 subdimensiones 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 Obtiene información detallada del trabajo especificado. Esta información incluye módulos de trabajo que se ejecutan como parte del trabajo.
Get-SCDWJobSchedule El cmdlet Get-SCDWJobSchedule muestra información de programación para trabajos de Data Warehouse. Puedes usar el parámetro JobName para especificar un trabajo para el que mostrar información de la 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 borra 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 para el módulo de trabajo especificado.
New-SCDWSourceType Para registrar un origen en el almacenamiento de datos, primero debe registrarse el tipo de origen de datos en el almacenamiento de datos. Este cmdlet ayuda a registrar un nuevo tipo de origen de datos al importar el módulo de administración adecuado y realizar los cambios de configuración correspondientes.
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 del 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 Actualiza 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