Configurar e utilizar cmdlets de Service Manager para Windows PowerShell

Artigo
04/18/2024

Importante

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

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

Antes de poder executar qualquer comando na interface de linha de comandos Windows PowerShell no Service Manager, tem de definir a política de execução como RemoteSigned. Antes de poder executar cmdlets do armazém de dados, tem de importar manualmente o módulo de cmdlets do armazém de dados.

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

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

Introdução aos cmdlets Service Manager

Windows PowerShell é uma shell de linha de comandos do Windows que inclui uma linha de comandos interativa e um ambiente de scripting. Windows PowerShell utiliza cmdlets para manipular os objetos Windows PowerShell. Service Manager inclui muitos cmdlets que pode utilizar para executar várias tarefas relacionadas com Service Manager sem utilizar a consola do Service Manager. Por exemplo, pode utilizar o cmdlet Import-SCSMManagementPack para importar um pacote de gestão.

Os cmdlets Service Manager são fornecidos em dois módulos listados abaixo. No Service Manager, estes módulos de cmdlet não são instalados no caminho típico listado na variável $env:PSModulePath. Por conseguinte, se 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 armazém de dados: o módulo Microsoft.EnterpriseManagement.Warehouse.Cmdlets que contém os cmdlets necessários para operar no armazém de dados Service Manager.

Os cmdlets do armazém de dados operam na base de dados do armazém de dados e pode executá-los no servidor de gestão de Service Manager ou no servidor de gestão do armazém de dados.

Os dados devolvidos pelo comando Windows PowerShell podem conter mais informações do que as que podem ser apresentadas numa janela de comandos de Windows PowerShell predefinida. Recomendamos que aumente a largura da janela de comandos: clique com o botão direito do rato na barra de título, selecione Propriedades e, no separador Esquema , defina a largura do Tamanho da Memória Intermédia do Ecrã como 120.

Os seguintes procedimentos ajudam-no a começar a utilizar Service Manager cmdlets.

Para abrir uma sessão de Service Manager Windows PowerShell a partir da consola do Service Manager

Na consola 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 a partir do Windows

No computador que aloja o servidor de gestão 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 de Service Manager Windows PowerShell.
Para listar os cmdlets incluídos no módulo de administrador, na sessão de Service Manager Windows PowerShell, introduza o seguinte e, em seguida, prima ENTER:
```
Get-Command -module System.Center.Service.Manager
```
Para listar os cmdlets incluídos no módulo do armazém de dados, na sessão Service Manager Windows PowerShell, introduza o seguinte e, em seguida, prima ENTER:
```
Get-Command -module Microsoft.EnterpriseManagement.Warehouse.Cmdlets
```

Para obter Ajuda para um cmdlet

Abra uma sessão de Service Manager Windows PowerShell.
Agora pode aceder à Ajuda na caixa ou pode utilizar o -online parâmetro para aceder à Ajuda online mais atualizada:
- Ajuda na caixa: escreva o seguinte comando. Substitua cmdlet-name pelo nome do cmdlet para o qual pretende obter ajuda, por exemplo , Import-SCSMManagementPack:
```
Get-help <cmdlet-name> -detailed
```
- Ajuda Online atualizada: escreva o seguinte comando e, em seguida, prima ENTER:
```
Get-help <cmdlet-name> -online
```
  Este comando utiliza o -online parâmetro para aceder à Ajuda online mais recente de um cmdlet. Abre um browser e apresenta a Ajuda online que está disponível para cmdlet-name.

Lista dos cmdlets Service Manager

Service Manager suporta os seguintes cmdlets Windows PowerShell, que são implementados em dois módulos: o módulo de administrador e o módulo do armazém de dados.

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

Cmdlet	Descrição
Add-SCSMAllowListClass	Adiciona as classes especificadas à lista Permitir das classes utilizadas pelo Conector de CI do Service Manager Operations Manager durante a sincronização.
Export-SCSMManagementPack	Exporta um pacote de gestão como um ficheiro com formato XML válido que pode importar posteriormente para o Service Manager ou o Operations Manager.
Get-SCSMAllowList	Obtém a lista Permitir das classes utilizadas pelo conector de CI do Service Manager Operations Manager durante a sincronização.
Get-SCSMAnnouncement	Recupera os anúncios que são definidos no Service Manager.
Get-SCSMChannel	Obtém os canais de Notificação de E-mail que estão definidos no Service Manager.
Get-SCSMClass	Obtém uma classe.
Get-SCSMClassInstance	Obtém objetos de instância de classe.
Get-SCSMCommand
Get-SCSMConnector	Obtém os conectores que estão definidos no Service Manager.
Get-SCSMDCMWorkflow	Obtém a lista de fluxos de trabalho de gestão de configuração pretendidos que são definidos no Service Manager.
Get-SCSMDeletedItem	Obtém itens que foram marcados anteriormente para eliminação no Service Manager.
Get-SCSMDiscovery	Obtém informações de deteção do Operations Manager e do Service Manager.
Get-SCSMEmailTemplate	Obtém modelos de E-mail que estão definidos no Service Manager.
Get-SCSMEmailTemplateContent	Obtém o conteúdo dos modelos de E-mail do Service Manager.
Get-SCSMGroup	Obtém grupos do Operations Manager e de Service Manager.
Get-SCSMManagementGroupConnection	Obtém todas as ligações do grupo de gestão, incluindo o estado IsActive destas ligações. Apenas uma ligação terá o estado IsActive definido como Verdadeiro porque apenas uma ligação pode estar ativa de cada vez.
Get-SCSMManagementPack	Obtém objetos que representam pacotes de gestão que foram importados.
Get-SCSMObjectTemplate	Obtém um modelo de objeto.
Get-SCSMQueue	Obtém as filas que estão definidas no Service Manager.
Get-SCSMRelationship	Obtém informações sobre objetos de relação do Operations Manager e de Service Manager.
Get-SCSMRelationshipInstance	Obtém as instâncias de relações do Operations Manager e do Service Manager.
Get-SCSMRunAsAccount	Obtém contas Run As.
Get-SCSMSetting	Obtém definições de configuração do System Center Service Manager.
Get-SCSMSubscription	Obtém as subscrições que estão configuradas no Service Manager.
Get-SCSMTask	Obtém as tarefas que estão definidas no Service Manager.
Get-SCSMUser	Obtém os utilizadores que estão definidos no Service Manager.
Get-SCSMUserRole	Obtém as funções de utilizador que estão definidas no Service Manager.
Get-SCSMView	Obtém as visualizações que são definidas no Service Manager.
Get-SCSMWorkflow	Obtém a informação de configuração para os fluxos de trabalho do Service Manager.
Get-SCSMWorkflowStatus	Obtém o estado dos fluxos de trabalho no Service Manager.
Import-SCSMInstance	Importa objetos e relações de um ficheiro de valores separados por vírgulas (.csv) para o Service Manager.
Import-SCSMManagementPack	Importa pacotes de gestão.
New-SCOrchestratorConnector	Cria um novo conector do Orchestrator do Service Manager.
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 utilizada com um conector de alertas do Operations Manager no Service Manager.
New-SCSMAnnouncement	Cria um novo anúncio no Service Manager.
New-SCSMClassInstance	Adiciona uma instância de classe à base de dados.
New-SCSMCMConnector	Cria um novo conector do Configuration Manager no Service Manager.
New-SCSMDCMWorkflow	Cria um novo fluxo de trabalho de gestão de configuração pretendido no Service Manager.
New-SCSMEmailTemplate	Cria um novo modelo de E-mail para o Service Manager.
New-SCSMManagementGroupConnection	Cria uma nova ligação para o grupo de gestão especificado. A ligação de grupo de gestão mais recente criada é a ligação ativa que os cmdlets Get- utilizam por predefinição, na qual não especificou o ComputerName e a Credential ou os parâmetros SCSession .
New-SCSMManagementPack	Cria um novo pacote de gestão.
New-SCSMManagementPackBundle	Agrupa pacotes de gestão individual e os seus recursos, de modo a criar um novo agrupamento de pacote de gestão.
New-SCSMOMAlertConnector	Cria um novo conector de alertas 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 Run As.
New-SCSMSubscription	Cria uma nova subscrição no Service Manager.
New-SCSMUserRole	Cria uma nova função de utilizador no Service Manager.
New-SCSMWorkflow	Cria um novo fluxo de trabalho no Service Manager.
New-SCVMMConnector	Cria um novo conector do Virtual Machine Manager do Service Manager.
Protect-SCSMManagementPack	Sela um pacote de gestão que impede que seja modificado.
Remove-SCSMAllowListClass	Remove as classes especificadas da lista Permitir das classes que são utilizadas pelo Conector CI do Operations Manager durante a sincronização no Service Manager.
Remove-SCSMAnnouncement	Remove um anúncio 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 gestão de configuração pretendido do Service Manager.
Remove-SCSMEmailTemplate	Remove um modelo de E-mail do Service Manager.
Remove-SCSMManagementGroupConnection	Remove uma ligação de grupo de gestão.
Remove-SCSMManagementPack	Remove pacotes de gestão.
Remove-SCSMRunAsAccount	Remove uma conta Run As.
Remove-SCSMSubscription	Remove uma subscrição do Service Manager.
Remove-SCSMUserRole	Remove uma função de utilizador do Service Manager.
Remove-SCSMWorkflow	Remove um fluxo de trabalho do Service Manager.
Reset-SCSMAllowList	Repõe a lista Permitir das classes utilizadas pelo Conector CI do Operations Manager no Service Manager para a lista de Permissões predefinida.
Restore-SCSMDeletedItem	Restaura itens que foram eliminados anteriormente no Service Manager.
Set-SCSMChannel	Define as propriedades do canal de notificação de e-mail no Service Manager.
Set-SCSMManagementGroupConnection	Define a ligação especificada como a ligação ativa. A ligação ativa é a ligação que é utilizada implicitamente quando executa um cmdlet Get- sem especificar os parâmetros -ComputerName e -Credential ou -SCSession . Apenas uma ligação pode estar ativa em qualquer altura e, por predefinição, a ligação ativa é a última ligação que foi criada com o cmdlet New-SCManagementGroupConnection .
Start-SCSMConnector	Inicia um conector Service Manager.
Test-SCSMManagementPack	Testa a validade de um pacote de gestão.
Update-SCSMAnnouncement	Atualiza as propriedades de um anúncio 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 de Service Manager.
Update-SCSMDCMWorkflow	Atualizações propriedades de um fluxo de trabalho de gestão de configuração pretendido.
Update-SCSMEmailTemplate	Atualiza propriedades de um modelo E-mail.
Update-SCSMRunAsAccount	Atualizações as credenciais associadas a uma conta Run As.
Update-SCSMSetting	Atualiza as definições de configuração do Service Manager.
Update-SCSMSubscription	Atualiza as propriedades de subscrição no Service Manager.
Update-SCSMUserRole	Define a propriedade UserRole para um utilizador do Service Manager.
Update-SCSMWorkflow	Atualiza as propriedades do fluxo de trabalho.

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

Cmdlet	Descrição
Disable-SCDWJob	Desactiva um trabalho do armazém de dados para evitar a respectiva execução.
Disable-SCDWJobSchedule	O cmdlet Disable-SCDWJobSchedule desativa um agendamento de tarefas Data Warehouse, o que faz com que o agendamento do trabalho deixe de iniciar tarefas. Se o agendamento de trabalhos tiver sido previamente activado, a sua desactivação mantém as definições do agendamento de trabalhos. Para modificar as definições de agendamento de tarefas, execute o cmdlet Set-SCDWJobSchedule .
Disable-SCDWSource	Ativa todas as tarefas afiliadas à origem de dados especificada.
Enable-SCDWJob	Activa um trabalho do Armazém de Dados de modo a ser executado de acordo com o respectivo agendamento.
Enable-SCDWJobSchedule	O cmdlet Enable-SCDWJobSchedule permite aos administradores Data Warehouse ativar agendamentos de tarefas para que as tarefas sejam executadas de acordo com a agenda especificada. Para desativar o agendamento da tarefa, utilize o cmdlet Disable-SCDWJobSchedule .
Enable-SCDWSource	Ativa todas as tarefas afiliadas à origem de dados especificada.
Get-SCDWEntity	Obtém a lista de tabelas de factos, dimensões, tabelas e limites que existem num armazém de dados.
Get-SCDWJob	Obtém o estado da tarefa de todos os trabalhos recorrentes, incluindo trabalhos de extração, transformação e carga (ETL).
Get-SCDWJobModule	Devolve informações detalhadas do trabalho especificado. Estas informações incluem módulos do trabalho que são executados como parte do trabalho.
Get-SCDWJobSchedule	O cmdlet Get-SCDWJobSchedule apresenta informações de agendamento para Data Warehouse tarefas. Pode utilizar o parâmetro JobName para especificar uma tarefa para a qual apresentar informações de agendamento. Caso contrário, o cmdlet Get-SCDWJobSchedule apresenta informações de agendamento para todas as tarefas de Data Warehouse.
Get-SCDWModule
Get-SCDWRetentionPeriod	O Data Warehouse prepara as linhas após um período de retenção predefinido. Este cmdlet dá o período de retenção de uma determinada entidade em minutos. Se não for fornecida nenhuma entidade, devolve o período de retenção predefinido para todas as entidades.
Get-SCDWSource	Ativa todas as tarefas afiliadas à origem de dados especificada.
Get-SCDWSourceType	Obtém os tipos de origens de dados que podem ser registadas no armazém de dados.
Get-SCDWWatermark	Obtém a marca d'água mais recente para o módulo de tarefa especificado.
New-SCDWSourceType	Para registar uma origem no Data Warehouse, o Tipo de Origem de Dados tem primeiro de ser registado no Data Warehouse. Este cmdlet ajuda a registar um novo Tipo de Origem de Dados ao importar o pacote de gestão adequado e efetuar as alterações de configuração adequadas.
Register-SCDWSource	Regista instâncias de tipos de origem de dados, como Service Manager, Operations Manager e Configuration Manager, no armazém de dados.
Set-SCDWJobSchedule	Define o agendamento para um trabalho do Armazém de Dados.
Set-SCDWRetentionPeriod	Define o período de retenção de dados em minutos para uma tabela de factos específica numa base de dados de armazém de dados específica ou define a predefinição para tabelas de factos na base de dados.
Set-SCDWSource	Atualizações a definição de classes e relações que podem ser preenchidas para uma instância de uma origem de dados.
Set-SCDWWatermark	- Define a marca d'água a partir da qual o processamento de dados subsequente deve continuar.
Start-SCDWJob	Inicia um trabalho do Armazém de Dados.
Unregister-SCDWManagememtPack
Unregister-SCDWSource	Anule o registo de uma origem de dados do armazém de dados.

Passos seguintes

Para realizar tarefas de manutenção em tarefas do armazém de dados, veja Gerir o armazém de dados.

Partilhar via