Configurar e utilizar cmdlets de Service Manager para Windows PowerShell
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.ManagerPara 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
-onlineparâ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> -detailedAjuda Online atualizada: escreva o seguinte comando e, em seguida, prima ENTER:
Get-help <cmdlet-name> -onlineEste comando utiliza o
-onlineparâ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.