Configurar e usar cmdlets Service Manager para Windows PowerShell

Artigo
04/18/2024

Importante

Esta versão do Service Manager chegou ao fim do suporte. Recomendamos que você atualize para o Service Manager 2022.

Este artigo fornece uma introdução aos cmdlets Service Manager para a interface de linha de comando Windows PowerShell.

Antes de executar qualquer comando na interface de linha de comando Windows PowerShell no Service Manager, você deve definir a política de execução como RemoteSigned. Antes de executar cmdlets de data warehouse, você deve importar manualmente o módulo de cmdlets do data warehouse.

Os cmdlets Service Manager são implementados nos dois módulos a seguir:

System.Center.Service.Manager. Este módulo é importado automaticamente sempre que uma sessão de Service Manager Windows PowerShell é aberta.
Microsoft.EnterpriseManagement.Warehouse.Cmdlets. Este módulo deve ser importado manualmente.

Introdução aos cmdlets Service Manager

O Windows PowerShell é um shell de linha de comando do Windows que inclui um prompt interativo e um ambiente de script. Windows PowerShell usa cmdlets para manipular os objetos Windows PowerShell. Service Manager inclui muitos cmdlets que você pode usar para executar várias tarefas relacionadas a Service Manager sem usar o console do Service Manager. Por exemplo, você pode usar o cmdlet Import-SCSMManagementPack para importar um pacote de gerenciamento.

Os cmdlets Service Manager são entregues em dois módulos listados abaixo. Em Service Manager, esses módulos de cmdlet não são instalados no caminho típico listado na variável $env:PSModulePath. Portanto, se você executar o Get-Module -List cmdlet , os módulos Service Manager não serão listados.

Cmdlets de administrador: o módulo System.Center.Service.Manager que contém os cmdlets necessários para tarefas administrativas comuns.
Cmdlets do data warehouse: o módulo Microsoft.EnterpriseManagement.Warehouse.Cmdlets que contém os cmdlets necessários para operar no data warehouse Service Manager.

Os cmdlets do data warehouse operam no banco de dados do data warehouse e você pode executá-los no servidor de gerenciamento do Service Manager ou no servidor de gerenciamento do data warehouse.

Os dados retornados do comando do Windows PowerShell podem conter mais informações do que é possível exibir em uma janela de comando padrão do Windows PowerShell. É recomendável aumentar a largura da janela de comando: clique com o botão direito do mouse na barra de título, selecione Propriedades e, na guia Layout , defina a largura tamanho do buffer de tela como 120.

Os procedimentos a seguir ajudam você a começar a usar Service Manager cmdlets.

Para abrir uma sessão de Service Manager Windows PowerShell no console do Service Manager

No console do Service Manager, selecione Administração.
No painel Tarefas , selecione Iniciar Sessão do PowerShell.

O módulo de cmdlet de administrador é automaticamente pré-importado nesta sessão.

Para abrir uma sessão de Service Manager Windows PowerShell do Windows

No computador que hospeda o servidor de gerenciamento Service Manager, na barra de tarefas, selecione Iniciar, aponte para Todos os Programas e selecione Microsoft System Center.
Selecione Service Manager <versão> e selecione Service Manager Shell.

O módulo de cmdlet de administrador é automaticamente pré-importado nesta sessão.

Para listar todos os cmdlets Service Manager

Abra uma sessão Service Manager Windows PowerShell.
Para listar os cmdlets incluídos no módulo de administrador, na sessão Service Manager Windows PowerShell, insira o seguinte e pressione ENTER:
```
Get-Command -module System.Center.Service.Manager
```
Para listar os cmdlets incluídos no módulo de data warehouse, na sessão Service Manager Windows PowerShell, insira o seguinte e pressione ENTER:
```
Get-Command -module Microsoft.EnterpriseManagement.Warehouse.Cmdlets
```

Para obter ajuda para um cmdlet

Abra uma sessão Service Manager Windows PowerShell.
Agora você pode acessar a Ajuda na caixa ou pode usar o -online parâmetro para acessar a Ajuda online mais atualizada:
- Ajuda na caixa: digite o seguinte comando. Substitua cmdlet-name pelo nome do cmdlet para o qual você deseja obter ajuda, por exemplo, Import-SCSMManagementPack:
```
Get-help <cmdlet-name> -detailed
```
- Ajuda online e atualizada: digite o seguinte comando e pressione ENTER:
```
Get-help <cmdlet-name> -online
```
  Esse comando usa o -online parâmetro para acessar a Ajuda online mais recente para um cmdlet. Ele abre um navegador da Web e exibe a Ajuda online que está disponível para cmdlet-name.

Lista dos cmdlets Service Manager

Service Manager dá suporte aos seguintes cmdlets Windows PowerShell, que são implementados em dois módulos: o módulo de administrador e o módulo de data warehouse.

Cmdlets de administrador no módulo System.Center.Service.Manager

Cmdlet	Descrição
Add-SCSMAllowListClass	Adiciona as classes especificadas à lista Permitir de classes usadas pelo conector de CI do Service Manager Operations Manager durante a sincronização.
Export-SCSMManagementPack	Exporta um pacote de gerenciamento como um arquivo válido formatado em XML que você pode importar posteriormente para Service Manager ou Operations Manager.
Get-SCSMAllowList	Recupera a lista Permitir de classes usadas pelo conector de CI do Service Manager Operations Manager durante a sincronização.
Get-SCSMAnnouncement	Recupera os comunicados que estão definidos no Service Manager.
Get-SCSMChannel	Recupera os canais de notificação por email que estão definidos no Service Manager.
Get-SCSMClass	Recupera uma classe.
Get-SCSMClassInstance	Recupera objetos de instância de classe.
Get-SCSMCommand
Get-SCSMConnector	Recupera os conectores que estão definidos no Service Manager.
Get-SCSMDCMWorkflow	Recupera a lista de fluxos de trabalho de gerenciamento de configuração desejados definidos em Service Manager.
Get-SCSMDeletedItem	Recupera os itens que foram marcados para exclusão no Service Manager.
Get-SCSMDiscovery	Recupera informações de descoberta do Operations Manager e de Service Manager.
Get-SCSMEmailTemplate	Recupera modelos de email que estão definidos no Service Manager.
Get-SCSMEmailTemplateContent	Recupera o conteúdo dos modelos de email do Service Manager.
Get-SCSMGroup	Recupera grupos do Operations Manager e de Service Manager.
Get-SCSMManagementGroupConnection	Ele recupera todas as conexões do grupo de gerenciamento, incluindo o estado IsActive dessas conexões. Somente uma conexão terá seu conjunto de estado IsActive definido como True, porque não é possível ter duas ou mais conexões ativas simultaneamente.
Get-SCSMManagementPack	Recupera objetos que representam pacotes de gerenciamento que foram importados.
Get-SCSMObjectTemplate	Recupera um modelo de objeto.
Get-SCSMQueue	Recupera as filas que estão definidas no Service Manager.
Get-SCSMRelationship	Recupera informações sobre objetos de relação do Operations Manager e de Service Manager.
Get-SCSMRelationshipInstance	Recupera as instâncias de relações do Operations Manager e do Service Manager.
Get-SCSMRunAsAccount	Recupera contas Executar como.
Get-SCSMSetting	Recupera as definições de configuração do System Center Service Manager.
Get-SCSMSubscription	Recupera as assinaturas que estão configuradas no Gerenciador de serviço.
Get-SCSMTask	Recupera as tarefas que estão definidas no Service Manager.
Get-SCSMUser	Recupera os usuários que estão definidos no Service Manager.
Get-SCSMUserRole	Recupera as funções de usuário que estão definidas no Service Manager.
Get-SCSMView	Recupera as exibições que estão definidas no Service Manager.
Get-SCSMWorkflow	Recupera as informações de configuração para fluxos de trabalho do Service Manager.
Get-SCSMWorkflowStatus	Recupera o status dos fluxos de trabalho no Service Manager.
Import-SCSMInstance	Ele importa objetos e relações de um arquivo de valores separados por vírgula (.csv) para o Service Manager.
Import-SCSMManagementPack	Importa pacotes de gerenciamento.
New-SCOrchestratorConnector	Cria um novo conector do Service Manager Orchestrator.
New-SCRelationshipInstance	Cria uma instância de uma relação.
New-SCSMADConnector	Cria um novo conector do Active Directory.
New-SCSMAlertRule	Cria uma regra de alerta a ser usada com um conector de alerta do Operations Manager no Service Manager.
New-SCSMAnnouncement	Cria um novo comunicado no Service Manager.
New-SCSMClassInstance	Adiciona uma instância de classe ao banco de dados.
New-SCSMCMConnector	Cria um novo conector do Configuration Manager no Service Manager.
New-SCSMDCMWorkflow	Cria um novo fluxo de trabalho de gerenciamento de configuração desejado em Service Manager.
New-SCSMEmailTemplate	Cria um novo modelo de email para o Service Manager.
New-SCSMManagementGroupConnection	Cria uma nova conexão para o grupo de gerenciamento especificado. A conexão de grupo de gerenciamento mais recente que foi criada é a conexão ativa que os cmdlets Get-usam por padrão, na qual você não especificou o ComputerName e a Credencial ou os parâmetros SCSession .
New-SCSMManagementPack	Cria um novo pacote de gerenciamento.
New-SCSMManagementPackBundle	Agrupa pacotes de gerenciamento individuais e seus recursos, criando um novo conjunto de pacotes de gerenciamento.
New-SCSMOMAlertConnector	Cria um novo conector de alerta do Operations Manager no Service Manager.
New-SCSMOMConfigurationItemConnector	Cria um novo conector de IC do Operations Manager no Service Manager.
New-SCSMRunAsAccount	Cria uma nova conta Executar como.
New-SCSMSubscription	Cria uma nova assinatura no Service Manager.
New-SCSMUserRole	Cria uma nova função de usuário no Service Manager.
New-SCSMWorkflow	Cria um novo fluxo de trabalho no Service Manager.
New-SCVMMConnector	Cria um novo conector do Service Manager Virtual Machine Manager.
Protect-SCSMManagementPack	Lacra um pacote de gerenciamento, evitando que ele seja modificado.
Remove-SCSMAllowListClass	Remove as classes especificadas da lista Permitir de classes que são usadas pelo Conector de CI do Operations Manager durante a sincronização no Service Manager.
Remove-SCSMAnnouncement	Remove um comunicado do Service Manager.
Remove-SCSMClassInstance	Remove uma instância de um objeto de item de configuração.
Remove-SCSMConnector	Remove um conector do Service Manager.
Remove-SCSMDCMWorkflow	Remove um fluxo de trabalho de gerenciamento de configuração desejado de Service Manager.
Remove-SCSMEmailTemplate	Remove um modelo de email do Service Manager.
Remove-SCSMManagementGroupConnection	Remove uma conexão de grupo de gerenciamento.
Remove-SCSMManagementPack	Remove os pacotes de gerenciamento.
Remove-SCSMRunAsAccount	Remove uma conta Executar como.
Remove-SCSMSubscription	Remove uma assinatura do Service Manager.
Remove-SCSMUserRole	Remove uma função de usuário do Service Manager.
Remove-SCSMWorkflow	Remove um fluxo de trabalho do Service Manager.
Reset-SCSMAllowList	Redefine a lista Permitir de classes usadas pelo Conector de CI do Operations Manager em Service Manager para a lista de permissões padrão.
Restore-SCSMDeletedItem	Restaura itens que foram excluídos anteriormente em Service Manager.
Set-SCSMChannel	Define as propriedades do canal de notificação por email no Service Manager.
Set-SCSMManagementGroupConnection	Define a conexão especificada como a conexão ativa. A conexão ativa é a conexão que é usada implicitamente quando você executa um cmdlet Get- sem especificar parâmetros -ComputerName e -Credential ou -SCSession . Somente uma conexão pode estar ativa a qualquer momento e, por padrão, a conexão ativa é a última conexão que foi criada usando o cmdlet New-SCManagementGroupConnection .
Start-SCSMConnector	Inicia um conector Service Manager.
Test-SCSMManagementPack	Testa a validade de um pacote de gerenciamento.
Update-SCSMAnnouncement	Atualiza as propriedades de um comunicado do Service Manager.
Update-SCSMClassInstance	Atualizações valores de propriedade de uma instância de classe de item de configuração.
Update-SCSMConnector	Atualizações propriedades de um conector Service Manager.
Update-SCSMDCMWorkflow	Atualizações propriedades de um fluxo de trabalho de gerenciamento de configuração desejado.
Update-SCSMEmailTemplate	Atualiza as propriedades de um modelo de email.
Update-SCSMRunAsAccount	Atualizações as credenciais associadas a uma conta Executar como.
Update-SCSMSetting	Atualiza as definições de configuração do Service Manager.
Update-SCSMSubscription	Atualiza propriedades de assinatura no Service Manager.
Update-SCSMUserRole	Define a propriedade UserRole para um usuário do Service Manager.
Update-SCSMWorkflow	Atualiza as propriedades de fluxo de trabalho.

Data Warehouse cmdlets no módulo Microsoft.EnterpriseManagement.Warehouse.Cmdlets

Cmdlet	Descrição
Disable-SCDWJob	Desabilita um trabalho de data warehouse para impedir que ele seja executado.
Disable-SCDWJobSchedule	O cmdlet Disable-SCDWJobSchedule desabilita uma Data Warehouse agenda de trabalho, o que faz com que a agenda de trabalho pare de iniciar trabalhos. Se o cronograma de trabalho já estava habilitado, desabilitá-lo fará com que as suas configurações sejam mantidas. Para modificar as configurações de agendamento de trabalho, execute o cmdlet Set-SCDWJobSchedule .
Disable-SCDWSource	Habilita todos os trabalhos afiliados à fonte de dados especificada.
Enable-SCDWJob	Habilita um trabalho de Data Warehouse, para que ele possa ser executado de acordo com seu cronograma.
Enable-SCDWJobSchedule	O cmdlet Enable-SCDWJobSchedule permite que Data Warehouse administradores habilitem agendamentos de trabalho para que os trabalhos sejam executados de acordo com a agenda especificada. Para desabilitar a agenda de trabalho, use o cmdlet Disable-SCDWJobSchedule .
Enable-SCDWSource	Habilita todos os trabalhos afiliados à fonte de dados especificada.
Get-SCDWEntity	Obtém a lista de tabelas de fatos, dimensões, tabelas e outriggers que existem em um data warehouse.
Get-SCDWJob	Obtém o trabalho status de todos os trabalhos recorrentes, incluindo trabalhos etl (extração, transformação e carga).
Get-SCDWJobModule	Retorna informações detalhadas para o trabalho especificado. Essas informações incluem módulos de trabalho que são executados como parte do trabalho.
Get-SCDWJobSchedule	O cmdlet Get-SCDWJobSchedule exibe informações de agendamento para trabalhos Data Warehouse. Você pode usar o parâmetro JobName para especificar um trabalho para o qual exibir informações de agendamento. Caso contrário, o cmdlet Get-SCDWJobSchedule exibirá informações de agendamento para todos os trabalhos Data Warehouse.
Get-SCDWModule
Get-SCDWRetentionPeriod	O Data Warehouse prepara as linhas após um período de retenção predefinido. Esse cmdlet fornece o período de retenção para uma entidade específica em minutos. Se nenhuma entidade for fornecida, ela devolverá o período de retenção padrão para todas as entidades.
Get-SCDWSource	Habilita todos os trabalhos afiliados à fonte de dados especificada.
Get-SCDWSourceType	Obtém os tipos de fontes de dados que podem ser registradas no data warehouse.
Get-SCDWWatermark	Obtém a marca d'água mais recente para o módulo de trabalho especificado.
New-SCDWSourceType	Para registrar uma fonte com o Data Warehouse, o Tipo de Fonte de Dados primeiro precisa ser registrado com o Data Warehouse. Esse cmdlet ajuda a registrar um novo Tipo de Fonte de Dados importando o pacote de gerenciamento adequado e fazendo as alterações de configuração apropriadas.
Register-SCDWSource	Registra instâncias de tipos de fonte de dados, como Service Manager, Operations Manager e Configuration Manager, no data warehouse.
Set-SCDWJobSchedule	Define o cronograma para um trabalho de Data Warehouse.
Set-SCDWRetentionPeriod	Define o período de retenção de dados em minutos para uma tabela de fatos específica em um banco de dados de data warehouse específico ou define o padrão para tabelas de fatos dentro do banco de dados.
Set-SCDWSource	Atualizações a definição de classes e relações que podem ser populadas para uma instância de uma fonte de dados.
Set-SCDWWatermark	- Define a marca d'água da qual o processamento de dados subsequente deve continuar.
Start-SCDWJob	Inicia um trabalho de Data Warehouse.
Unregister-SCDWManagememtPack
Unregister-SCDWSource	Cancela o registro de uma fonte de dados do data warehouse.

Próximas etapas

Para executar tarefas de manutenção em trabalhos de data warehouse, consulte Gerenciar o data warehouse.

Compartilhar via