Configurar e usar cmdlets do Service Manager para Windows PowerShell

Artigo
11/06/2024

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

Antes de executar qualquer comando na interface de linha de comando do 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 de data warehouse.

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

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

Introdução aos cmdlets do Service Manager

O Windows PowerShell é um shell de linha de comando do Windows que inclui um prompt interativo e um ambiente de script. O Windows PowerShell usa cmdlets para manipular os objetos do Windows PowerShell. Service Manager inclui muitos cmdlets que você pode usar para executar várias tarefas relacionadas ao 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 do Service Manager são fornecidos em dois módulos listados abaixo. No 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 do Service Manager não serão listados.

Cmdlets do 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 do 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 podem ser exibidas em uma janela de comando padrão do Windows PowerShell. Recomendamos 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 do tamanho do buffer de tela como 120.

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

Abrir uma sessão do Windows PowerShell do Service Manager 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 do administrador é pré-importado automaticamente nesta sessão.

Abrir uma sessão do Windows PowerShell do Service Manager no Windows

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

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

Listar todos os cmdlets do Service Manager

Abra uma sessão do Windows PowerShell do Service Manager.
Para listar os cmdlets incluídos no módulo do administrador, na sessão do Windows PowerShell do Service Manager, 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 do Windows PowerShell do Service Manager, insira o seguinte e pressione ENTER:
```
Get-Command -module Microsoft.EnterpriseManagement.Warehouse.Cmdlets
```

Obter ajuda para um cmdlet

Abra uma sessão do Windows PowerShell do Service Manager.
Agora você pode acessar a Ajuda pronta para uso ou usar o -online parâmetro para acessar a Ajuda on-line mais atualizada:
- Ajuda pronta para uso: digite o comando a seguir. Substitua cmdlet-name pelo nome do cmdlet para o qual você deseja obter ajuda, por exemplo, Import-SCSMManagementPack:
```
Get-help <cmdlet-name> -detailed
```
- Ajuda on-line 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 de um cmdlet. Ele abre um navegador da Web e exibe a Ajuda online disponível para cmdlet-name.

Lista dos cmdlets do Service Manager

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

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

Cmdlet	Descrição
Add-SCSMAllowListClass	Adiciona as classes especificadas à lista de permissões de classes usadas pelo Conector de CI do Service Manager Operations Manager durante a sincronização.
Exportar-SCSMManagementPack	Exporta um pacote de gerenciamento como um arquivo formatado em XML válido que você pode importar posteriormente para Service Manager ou Operations Manager.
Get-SCSMAllowList	Recupera a lista de permissões de classes que é usada pelo Conector CI do Service Manager Operations Manager durante a sincronização.
Get-SCSMAnnouncement	Recupera anúncios definidos no Service Manager.
Get-SCSMChannel	Recupera os canais de notificação por email definidos no Service Manager.
Get-SCSMClass	Recupera uma classe.
Get-SCSMClassInstance	Recupera objetos de instância de classe.
Get-SCSMCommand
Get-SCSMConnector	Recupera conectores definidos no Service Manager.
Get-SCSMDCMWorkflow	Recupera a lista de fluxos de trabalho de gerenciamento de configuração desejados definidos no Service Manager.
Get-SCSMDeletedItem	Recupera itens que foram marcados para exclusão no Service Manager.
Get-SCSMDiscovery	Recupera informações de descoberta do Operations Manager e do Service Manager.
Get-SCSMEmailTemplate	Recupera modelos de email 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 do Service Manager.
Get-SCSMManagementGroupConnection	Recupera todas as conexões do grupo de gerenciamento, incluindo o estado IsActive dessas conexões. Apenas uma conexão terá seu estado IsActive definido como True, pois apenas uma conexão pode estar ativa a qualquer momento.
Get-SCSMManagementPack	Recupera objetos que representam pacotes de gerenciamento que foram importados.
Get-SCSMObjectTemplate	Recupera um modelo de objeto.
Get-SCSMQueue	Recupera filas definidas no Service Manager.
Get-SCSMRelationship	Recupera informações sobre objetos de relação do Operations Manager e do 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 assinaturas configuradas no Service Manager.
Get-SCSMTask	Recupera tarefas definidas no Service Manager.
Get-SCSMUser	Recupera usuários definidos no Service Manager.
Get-SCSMUserRole	Recupera funções de usuário definidas no Service Manager.
Get-SCSMView	Recupera exibições definidas no Service Manager.
Get-SCSMWorkflow	Recupera 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	Importa objetos e relações de um arquivo de valores separados por vírgula (.csv) para 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.
Novo-SCSMADConnector	Cria um novo conector do Active Directory.
Regra nova SCSMAlert	Cria uma regra de alerta a ser usada com um conector de alerta do Operations Manager no Service Manager.
Novo-SCSMAnouncement	Cria um novo comunicado no Service Manager.
New-SCSMClassInstance	Adiciona uma instância de classe ao banco de dados.
Novo-SCSMCMConnector	Cria um novo conector do Configuration Manager no Service Manager.
Novo-SCSMDCMWorkflow	Cria um novo fluxo de trabalho de gerenciamento de configuração desejado no Service Manager.
New-SCSMEmailTemplate	Cria um novo modelo de email para 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.
Novo-SCSMManagementPack	Cria um novo pacote de gerenciamento.
New-SCSMManagementPackBundle	Agrupa pacotes de gerenciamento individuais e seus recursos, criando um novo pacote de pacotes de gerenciamento.
Novo-SCSMOMAlertConnector	Cria um novo conector de alerta do Operations Manager no Service Manager.
New-SCSMOMConfigurationItemConnector	Cria um novo conector de CI do Operations Manager no Service Manager.
New-SCSMRunAsAccount	Cria uma nova conta Executar como.
Novo-SCSMSubscription	Cria uma nova assinatura no Service Manager.
New-SCSMUserRole	Cria uma nova função de usuário no Service Manager.
Novo SCSMWorkflow	Cria um novo fluxo de trabalho no Service Manager.
Novo-SCVMMConnector	Cria um novo conector do Service Manager Virtual Machine Manager.
Pacote de gerenciamento Protect-SCSMM	Sela um pacote de gerenciamento, impedindo que ele seja modificado.
Classe de remoção de SCSMAllowListClass	Remove as classes especificadas da lista Permitir de classes usadas pelo Conector de CI do Operations Manager durante a sincronização no Service Manager.
Remover-SCSMAnnouncement	Remove um comunicado do Service Manager.
Remove-SCSMClassInstance	Remove uma instância de um objeto de item de configuração.
Remover-SCSMConnector	Remove um conector do Service Manager.
Remover-SCSMDCMWorkflow	Remove um fluxo de trabalho de gerenciamento de configuração desejado do Service Manager.
Remover-SCSMEmailTemplate	Remove um modelo de email do Service Manager.
Remove-SCSMManagementGroupConnection	Remove uma conexão de grupo de gerenciamento.
Remover-SCSMManagementPack	Remove pacotes de gerenciamento.
Remover-SCSMRunAsAccount	Remove uma conta Executar como.
Remover-SCSMSubscription	Remove uma assinatura do Service Manager.
Remover-SCSMUserRole	Remove uma função de usuário do Service Manager.
Remover-SCSMWorkflow	Remove um fluxo de trabalho do Service Manager.
Reset-SCSMAllowList	Redefine a lista de permissões de classes usada pelo Conector de CI do Operations Manager no Service Manager para a lista de permissões padrão.
Restaurar-SCSMDeletedItem	Restaura itens que foram excluídos anteriormente no 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 usada implicitamente quando você executa um cmdlet Get- sem especificar os parâmetros -ComputerName e -Credential ou -SCSession . Apenas uma conexão pode estar ativa a qualquer momento e, por padrão, a conexão ativa é a última conexão criada usando o cmdlet New-SCManagementGroupConnection .
Start-SCSMConnector	Inicia um conector do Service Manager.
Teste-SCSMManagementPack	Testa a validade de um pacote de gerenciamento.
Atualização-SCSMAnnouncement	Atualiza as propriedades de um comunicado para Service Manager.
Update-SCSMClassInstance	Atualiza os valores de propriedade de uma instância de classe de item de configuração.
Update-SCSMConnector	Atualiza as propriedades de um conector do Service Manager.
Update-SCSMDCMWorkflow	Atualiza as propriedades de um fluxo de trabalho de gerenciamento de configuração desejado.
Atualizar-SCSMEmailTemplate	Atualiza as propriedades de um modelo de e-mail.
Update-SCSMRunAsAccount	Atualiza as credenciais associadas a uma conta Executar como.
Update-SCSMSetting	Atualiza as definições de configuração do Service Manager.
Update-SCSMSubscription	Atualiza as propriedades de assinatura no Service Manager.
Update-SCSMUserRole	Define a propriedade UserRole para um usuário do Service Manager.
Update-SCSMWorkflow	Atualiza as propriedades do fluxo de trabalho.

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

Cmdlet	Descrição
Desativar-SCDWJob	Desabilita um trabalho de data warehouse para impedir que ele seja executado.
Desativar-SCDWJobSchedule	O cmdlet Disable-SCDWJobSchedule desabilita um agendamento de trabalho do Data Warehouse, o que faz com que o agendamento de trabalho pare de iniciar trabalhos. Se o agendamento de trabalho tiver sido habilitado anteriormente, desabilitar o agendamento de trabalho manterá as configurações de agendamento de trabalho. Para modificar as configurações de agendamento de trabalho, execute o cmdlet Set-SCDWJobSchedule .
Desativar-SCDWSource	Habilita todos os trabalhos afiliados à fonte de dados especificada.
Habilitar-SCDWJob	Habilita um trabalho do Data Warehouse para que ele possa ser executado de acordo com sua agenda.
Ativar-SCDWJobSchedule	O cmdlet Enable-SCDWJobSchedule permite que os administradores do Data Warehouse habilitem agendamentos de trabalho para que os trabalhos sejam executados de acordo com o agendamento especificado. Para desabilitar o agendamento 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 subdimensões existentes em um data warehouse.
Get-SCDWJob	Obtém o status do trabalho de todos os trabalhos recorrentes, incluindo trabalhos de extração, transformação e carregamento (ETL).
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 do 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 do Data Warehouse.
Get-SCDWModule
Get-SCDWRetentionPeriod	O Data Warehouse elimina as linhas após um período de retenção predefinido. Esse cmdlet fornece o período de retenção de 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 no Data Warehouse, o Tipo de Fonte de Dados primeiro precisa ser registrado no 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.
Registro-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 agendamento de um trabalho do 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 no banco de dados.
Set-SCDWSource	Atualiza a definição de classes e relações que podem ser preenchidas para uma instância de uma fonte de dados.
Set-SCDWWatermark	- Define a marca d'água a partir da qual o processamento de dados subsequente deve continuar.
Iniciar-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