referência de atividade do fluxo de trabalho da Ferramenta de Criação de Service Manager
Importante
Esta versão do Service Manager chegou ao fim do suporte. Recomendamos que atualize para o Service Manager 2022.
Este artigo fornece orientações para programadores de tecnologias de informação (TI) para que possam criar atividades personalizadas do Windows Workflow Foundation (WF) que os profissionais de TI podem utilizar para criar fluxos de trabalho WF específicos dos respetivos processos de TI. As atividades WF personalizadas expandem a Biblioteca de Atividades , as atividades que são distribuídas com a Ferramenta de Criação Service Manager. A secção Referência de Atividades de Fluxos de Trabalho deste documento fornece detalhes sobre as atividades do WF predefinidas na Biblioteca de Atividades. Esta informação destina-se a ajudar os programadores (ou profissionais de TI que estão a agir como programadores) a criar atividades do WF personalizadas, conforme necessário.
Para obter informações sobre como utilizar atividades WF e fluxos de trabalho WF com Service Manager, veja Automatizar Processos de TI com Fluxos de Trabalho.
Atividades do Active Directory
Utilize as atividades Active Directory Domain Services (AD DS) para tornar as funções do Active Directory parte do fluxo de trabalho no Service Manager.
A Ferramenta de Criação de Service Manager fornece duas atividades de Service Manager predefinidas no grupo Atividades do Active Directory no painel Caixa de Ferramentas Atividades. As secções neste artigo descrevem estas atividades.
Adicionar Computador do AD DS a uma atividade de Grupo
Esta atividade adiciona um computador a um grupo de segurança no Active Directory Domain Services (AD DS) no Service Manager. O computador e o grupo têm de pertencer ao mesmo domínio e todos os contentores no domínio são pesquisados.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | Quando utilizar esta atividade, certifique-se de que a conta Service Manager Fluxo de Trabalho tem permissões suficientes para modificar grupos de segurança no AD DS. |
Propriedades
A atividade Adicionar Computador AD DS ao Grupo utiliza as propriedades de entrada descritas na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Domínio do Computador | ComputerDomain | String | Yes | O nome de domínio DNS completamente qualificado onde o computador está localizado (por exemplo, contoso.com). |
Nome do Computador | Completamente QualificadoComputerName | String | Yes | O nome do computador. |
Nome do Grupo | FullyQualifiedGroupName | String | Yes | O nome do grupo Active Directory Domain Services. |
A atividade Adicionar Computador do AD DS ao Grupo gera o resultado descrito na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Description |
---|---|---|---|
Saída | Saída | Booleano | O resultado da operação: Verdadeiro se a adição tiver sido efetuada com êxito; Falso se tiver falhado. |
Erros e exceções | Observações | Exemplo |
---|---|---|
Nenhuma | Nenhuma | Nenhuma |
Adicionar a atividade Utilizador do AD DS ao Grupo
Esta atividade adiciona um utilizador a um grupo de segurança no Active Directory Domain Services (AD DS) no Service Manager. O utilizador e o grupo têm de pertencer ao mesmo domínio e todos os contentores no domínio são pesquisados.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | Quando utilizar esta atividade, certifique-se de que a conta Service Manager Fluxo de Trabalho tem permissões suficientes para modificar grupos de segurança no AD DS. |
Propriedades
A atividade Adicionar Utilizador do AD DS ao Grupo utiliza as propriedades de entrada listadas na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Domínio do Utilizador | UserDomain | String | Yes | O nome de domínio completamente qualificado (FQDN) do utilizador. |
Nome de Utilizador | Nome de Utilizador | String | Yes | O nome de início de sessão do utilizador. |
Nome do Grupo | FullyQualifiedGroupName | String | Yes | O FQDN do grupo. |
A atividade Adicionar Utilizador do AD DS ao Grupo gera o resultado descrito na tabela seguinte.
Nome a Apresentar | Nome Interno | Tipo | Description |
---|---|---|---|
Saída | Saída | Booleano | O resultado da operação: Verdadeiro se a adição tiver sido efetuada com êxito, Falso se tiver falhado. |
Erros e exceções | Observações | Exemplo |
---|---|---|
Nenhuma | Nenhuma | Nenhuma |
Atividades do Fluxo de Controlo
Utilize atividades de fluxo de controlo para fornecer estrutura (ramos, ciclos ou atrasos de temporizador) para o fluxo de trabalho no Service Manager.
A Ferramenta de Criação fornece quatro atividades de fluxo de controlo predefinidas no grupo Fluxo de Controlo no painel Caixa de Ferramentas Atividades .
Atividade de atraso
Esta atividade introduz um atraso entre as atividades num fluxo de trabalho no Service Manager. A atividade Atraso é derivada da classe DelayActivity da Microsoft .NET Framework.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | Nenhuma |
Propriedades
A atividade Atraso utiliza as propriedades de entrada listadas na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Inicializar TimeoutDuration | InitializeTimeoutDuration | Interno | Especifica um processador para inicializar a propriedade TimeoutDuration . | |
Tempo LimiteDuração | Tempo LimiteDuração | Timespan | Yes | Duração do atraso. |
A atividade Atraso não produz uma propriedade de saída.
Erros e exceções | Observações | Exemplo |
---|---|---|
Nenhuma | Para obter mais informações sobre esta atividade, veja DelayActivity Class (Classe DelayActivity) na Biblioteca de Classes .NET Framework. | Nenhuma |
Para a atividade Cada Ciclo
A atividade For Each Loop utiliza como entrada uma matriz (coleção) de objetos e repete o conjunto de atividades dentro do ciclo para cada objeto na coleção. Por exemplo, se a coleção de entrada tiver cinco objetos, o ciclo itera cinco vezes. Se a coleção estiver vazia, o ciclo não itera. Não existe um limite superior para o número de objetos na coleção. A atividade Para Cada Ciclo é sempre executada no computador no qual o fluxo de trabalho é executado.
A atividade For Each Loop é uma atividade composta com dois contentores para atividades:
Contentor de Entrada: esta atividade configura o ciclo e define a coleção de entrada. Pode utilizar a atividade Obter Incidente ou Obter Máquina Virtual nesta função.
Contentor de Ciclo: com o nome ForEachChildActivity, esta atividade contém as atividades de ciclo. A maioria das atividades do Windows Workflow Foundation (WF) que coloca neste contentor têm duas propriedades adicionais: Item Atual e Propriedade para Vincular. Para cada atividade no contentor de ciclo, defina estas propriedades da seguinte forma:
Defina Item Atual para a propriedade Item Atual da atividade Contentor de Ciclo da atividade ForEach . Se esta atividade for a primeira atividade na atividade Para Cada Ciclo , o Item Atual é definido automaticamente.
Defina o valor da propriedade Propriedade como Vincular para o valor da propriedade da atividade atual que utiliza o valor Item Atual .
Dois tipos de atividades não obtêm as propriedades Item e Propriedade Atualpara Vincular e, por conseguinte, não podem utilizar os objetos na coleção de entrada:
Atividades de script, como a atividade script Windows PowerShell.
Atividades personalizadas ou outras atividades que não herdam da classe WorkflowActivityBase . Essas atividades incluem as atividades baseadas na classe Base de atividades , como atividades nativas do Visual Studio.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | Nenhuma |
Propriedades
A atividade For Each Loop utiliza as propriedades de entrada descritas na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Coleção de Entrada | InputCollection | Matriz/Objeto | N/D | Uma coleção de objetos a transmitir, um de cada vez, às atividades na atividade For Each Loop . Se a atividade que reside no contentor de entrada produzir uma matriz de objetos como propriedade de saída, a Coleção de Entrada é definida automaticamente para essa propriedade. Para ver o valor atual desta propriedade, clique com o botão direito do rato no contentor de ciclo e selecione Propriedades. |
Item Atual | CurrentItem | Objeto | N/D | Um índice na Coleção de Entrada que as atividades dentro do ciclo podem utilizar como uma propriedade de entrada. Para a primeira atividade no contentor de ciclo, esta propriedade é definida automaticamente. |
Erros e exceções | Observações | Exemplo |
---|---|---|
A atividade For Each Loop utiliza o serviço de controlo personalizado fornecido por Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções nas seguintes condições: - Se ocorrer algum erro na atividade ForEachLoop e não estiver relacionado com as atividades subordinadas, o fluxo de trabalho termina. - Se ocorrer algum erro nas atividades subordinadas, o fluxo de trabalho termina a menos que ContinueOnError=true. - Se alguma das propriedades de entrada for nula. A atividade não itera. Cada atividade na atividade For Each Loop tem de escrever os seus próprios erros ou exceções no serviço de controlo personalizado. A atividade For Each Loop não o faz por si só. |
Nenhuma | Nenhuma |
Atividade IfElse
Esta atividade controla a sequência de atividades num fluxo de trabalho com base numa condição booleana (Verdadeiro/Falso). Pode utilizar o resultado de uma atividade anterior, como uma atividade de script, para a condição.
A atividade IfElse é uma atividade do Visual Studio que utiliza regras e condições. Para obter mais informações sobre como utilizar regras e condições no Windows Workflow Foundation (WF), consulte Tutorial: Utilizar Regras e Condições no WF na Biblioteca MSDN.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | Nenhuma |
Propriedades
Nenhum.
Erros e exceções | Observações | Exemplo |
---|---|---|
Nenhuma | Para obter mais informações sobre a atividade IfElse, veja IfElseActivity Class (Classe IfElseActivity) na Biblioteca de Classes .NET Framework 4. | Nenhuma |
Atividade paralela
Esta atividade forja a sequência de atividades em duas sequências simultâneas de atividades. A atividade Paralela é uma atividade do Visual Studio. Para obter mais informações sobre a classe ParallelActivity, veja ParallelActivity Class (Classe ParallelActivity) na Biblioteca de Classes .NET Framework.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | Nenhuma |
Propriedades
Nenhum.
Erros e exceções | Observações | Exemplo |
---|---|---|
Nenhuma | Nenhuma | Nenhuma |
Atividades do Virtual Machine Manager
Utilize atividades de gestão de máquinas virtuais no Service Manager para criar fluxos de trabalho que permitam criar e atualizar máquinas virtuais. As atividades de gestão de máquinas virtuais suportam System Center Virtual Machine Manager.
A Ferramenta de Criação de Service Manager fornece as seguintes cinco atividades de gestão de máquinas virtuais predefinidas no grupo Atividades do VMM no painel Caixa de Ferramentas Atividades.
Obter atividade de VM
Esta atividade no Service Manager obtém uma lista de um ou mais IDs de máquina virtual de uma Biblioteca do Virtual Machine Manager (VMM).
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | - A consola do Virtual Machine Manager e Service Manager têm de ser instaladas no mesmo servidor. - Certifique-se de que a conta Service Manager Fluxo de Trabalho tem permissões suficientes para modificar grupos de segurança no Active Directory Domain Services (AD DS). - A consola do Virtual Machine Manager e Service Manager têm de ser instaladas no mesmo servidor. - Certifique-se de que a conta Service Manager Fluxo de Trabalho tem permissões suficientes para modificar grupos de segurança no Active Directory Domain Services (AD DS). |
Propriedades
A atividade Obter VM utiliza as propriedades de entrada na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Conjunto de Parâmetros | ParameterSet | String | Não; a predefinição é Ligação. | Especifica um subconjunto de parâmetros organizados para uma finalidade específica. Para a atividade Obter VM , pode selecionar um dos seguintes conjuntos de parâmetros: - Tudo: Procure todas as máquinas virtuais disponíveis. - ID: Procure uma máquina virtual com um ID conhecido. - Ligação: Procure máquinas virtuais ligadas ao servidor do Virtual Machine Manager (VMM) designado pela propriedade VMMServer . - VMHostGroup: Procure máquinas virtuais ligadas ao anfitrião da máquina virtual que é designado pela propriedade Anfitrião da VM . |
Continuar com o Erro | ContinueOnError | Booleano | N.º (A predefinição é Verdadeiro.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
Tem Erro | HasError | N/D | Especifica se a atividade tem um conjunto de erros. (Só de leitura) | |
Todos | Todos | Booleano | N.º (A predefinição é Verdadeiro.) | Disponível se o Conjunto de Parâmetros for Tudo. Se estiver definido como Verdadeiro, a atividade Obter VM devolve uma lista dos IDs da máquina virtual de todas as máquinas virtuais disponíveis. |
ID | ID | String | Necessário se o Conjunto de Parâmetros for ID. | Disponível se o Conjunto de Parâmetros for ID. Se estiver definido como Verdadeiro, a atividade Obter VM devolve uma lista dos IDs da máquina virtual de todas as máquinas virtuais cujos IDs de máquina virtual correspondem a todo ou a parte do valor de ID especificado. |
Grupo de Gestão | GrupoGestão | String | No | Especifica o grupo de gestão no qual esta atividade será executada. Defina como localhost. (Só de leitura) |
Servidor de Scripts | Destino | String | Yes | Especifica o nome DNS (Domain Name System) do servidor que executa a consola Service Manager. Não utilize localhost. |
Limite de Tempo do Script | TimeoutSeconds | Número inteiro | N.º (A predefinição é de 300 segundos.) | Especifica o número máximo de segundos para permitir a execução da atividade. |
Anfitrião de VM | VMHost | String | Necessário se o Conjunto de Parâmetros for VMHostGroup | Disponível se o Conjunto de Parâmetros for VMHostGroup. Se este conjunto de parâmetros estiver selecionado, a atividade Obter VM devolve uma lista dos IDs de máquina virtual de todas as máquinas virtuais em execução no anfitrião especificado. |
Nome da VM | VMName | String | No | Especifica o nome ou parte de um nome da máquina virtual a procurar. Se a cadeia fizer parte de um nome, a atividade obtém os IDs de todas as máquinas virtuais que contêm a cadeia. |
VMMServer | VMMServer | String | Yes | Especifica o nome do servidor System Center Virtual Machine Manager (VMM) que gere as máquinas virtuais. |
A atividade Obter VM gera o resultado descrito na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Comentários |
---|---|---|---|
VM IDs | VMIDList | Matriz de cadeias | Especifica a lista dos IDs das máquinas virtuais com nomes que correspondem a todos ou a parte da cadeia nome da VM . |
Erros e exceções | Observações | Exemplo |
---|---|---|
A atividade Obter VM utiliza o serviço de controlo personalizado fornecido pelo Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida. | Nenhuma | Nenhuma |
Mover a atividade da VM
Esta atividade no Service Manager move uma máquina virtual da Biblioteca do Virtual Machine Manager (VMM) para um anfitrião de manutenção.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | - A consola do Virtual Machine Manager e o Service Manager têm de estar ambos instalados no mesmo servidor. - Certifique-se de que a conta de Fluxo de Trabalho do Service Manager tem permissões suficientes para modificar grupos de segurança no Active Directory Domain Services (AD DS). |
Propriedades
A atividade Mover VM utiliza as propriedades de entrada na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Continuar com o Erro | ContinueOnError | Booleano | N.º (A predefinição é Verdadeiro.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
Tem Erro | HasError | N/D | Especifica se a atividade tem um conjunto de erros. (Só de leitura) | |
Bloquear O LM se o Anfitrião Estiver Ocupado | BlockLMIfHostBusy | Booleano | N.º (A predefinição é Falso.) | Bloqueia a repetição de uma migração em direto do Hyper-V se a migração tiver falhado porque o anfitrião de origem ou o anfitrião de destino já está a participar noutra migração em direto. |
Grupo de Tarefas | Grupo de Tarefas | Guid (cadeia) | No | Especifica um identificador para uma série de comandos que serão executados como um conjunto. |
Variável de Tarefa | JobVariable | String | No | Especifica que o progresso da tarefa é controlado e armazenado na variável denominada por este parâmetro. |
Grupo de Gestão | GrupoGestão | String | No | Especifica o grupo de gestão no qual esta atividade será executada. Defina como localhost. (Só de leitura) |
Caminho | Caminho | String | No | Especifica o destino da máquina virtual no anfitrião de manutenção. |
PROTipID | PROTipID | GUID | No | Especifica o ID da sugestão de Desempenho e Otimização de Recursos (PRO) que acionou esta ação. Permite futuras auditorias de sugestões PRO. |
Executar De forma Assíncrona | RunAsynchronously | Booleano | N.º (A predefinição é Falso.) | Especifica que a tarefa é executada de forma assíncrona para que o controlo regresse imediatamente à shell de comandos. |
Servidor de Scripts | Destino | String | Yes | Especifica o nome DNS (Domain Name System) do servidor que executa a consola Service Manager. Não utilize localhost. |
Limite de Tempo do Script | TimeoutSeconds | Número inteiro | N.º (A predefinição é de 300 segundos.) | Especifica o número máximo de segundos para permitir a execução da atividade. |
Iniciar VM no Destino | StartVMOnTarget | Booleano | N.º (A predefinição é Falso.) | Especifica que uma máquina virtual é iniciada assim que chega ao anfitrião de destino. |
Utilizar Cluster | UseCluster | Booleano | N.º (A predefinição é Falso.) | Força a utilização da Migração de Cluster do Windows Server 2008 para a transferência de uma máquina virtual que esteja num estado guardado para um anfitrião, mesmo que o cluster suporte a migração em direto do Hyper-V. |
Utilizar LAN | UseLan | Booleano | N.º (A predefinição é Falso.) | Força uma transferência através da rede local (LAN), mesmo que esteja disponível um mecanismo de transferência mais rápido, como uma transferência de rede de armazenamento (SAN). |
Anfitrião de VM | VMHostName | String | Yes | Especifica o nome do anfitrião de manutenção para o qual a máquina virtual será movida. |
ID da VM | VMID | String | Yes | Especifica o ID exclusivo da máquina virtual a mover. |
Servidor VMM | VMMServer | String | Yes | Especifica o nome do servidor System Center Virtual Machine Manager (VMM) que gere as máquinas virtuais. |
A atividade Mover VM gera o resultado descrito na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Comentários |
---|---|---|---|
ID da VM | VMID | String | Especifica o ID exclusivo da máquina virtual que foi movida. O ID da VM de entrada e o ID da VM de saída são iguais, a menos que a atividade não tenha encontrado uma máquina virtual com um ID de VM que corresponda ao ID da VM de entrada. Nesse caso, o ID da VM de saída está definido como Nulo. |
Erros e exceções | Observações | Exemplo |
---|---|---|
A atividade Mover VM utiliza o serviço de controlo personalizado fornecido pelo Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida. | Nenhuma | Nenhuma |
Encerrar a atividade da VM
Esta atividade no Service Manager encerra o sistema operativo convidado numa máquina virtual.
Só pode utilizar a atividade Encerrar VM numa máquina virtual num anfitrião baseado no Windows (um anfitrião Hyper-V ou um anfitrião do Servidor Virtual) apenas se os serviços de convidado de virtualização estiverem instalados na máquina virtual. Para uma máquina virtual implementada num anfitrião Hyper-V, o serviço convidado de virtualização chama-se Componentes de Integração. Para uma máquina virtual que é implementada num anfitrião do Servidor Virtual, o serviço de convidado de virtualização chama-se Adições de Máquina Virtual.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | - A consola do Virtual Machine Manager e Service Manager têm de ser instaladas no mesmo servidor. - Certifique-se de que a conta Service Manager Fluxo de Trabalho tem permissões suficientes para modificar grupos de segurança no Active Directory Domain Services (AD DS). |
Propriedades
A atividade De Encerramento da VM utiliza as propriedades de entrada descritas na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Continuar com o Erro | ContinueOnError | Booleano | N.º (A predefinição é Verdadeiro.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
Tem Erro | HasError | N/D | Especifica se a atividade tem um conjunto de erros. (Só de leitura) | |
Variável de Tarefa | JobVariable | String | No | Especifica que o progresso da tarefa é controlado e armazenado na variável com o nome deste parâmetro. |
Grupo de Gestão | GrupoGestão | String | No | Especifica o grupo de gestão no qual esta atividade será executada. Defina como localhost. (Só de leitura) |
PROTipID | PROTipID | GUID | No | Especifica o ID da sugestão de Desempenho e Otimização de Recursos (PRO) que acionou esta ação. Permite futuras auditorias de sugestões PRO. |
Executar De forma Assíncrona | RunAsynchronously | Booleano | N.º (A predefinição é Falso.) | Especifica que a tarefa é executada de forma assíncrona para que o controlo regresse imediatamente à shell de comandos. |
Servidor de Scripts | Destino | String | Yes | Especifica o nome do Sistema de Nomes de Domínio (DNS) do servidor que executa a consola do Service Manager. Não utilize Localhost. |
Limite de Tempo do Script | TimeoutSeconds | Número inteiro | N.º (A predefinição é 300 segundos.) | Especifica o número máximo de segundos para permitir a execução da atividade. |
ID da VM | VMID | String | Yes | Especifica o ID exclusivo da máquina virtual a encerrar. |
VMMServer | VMMServer | String | Yes | Especifica o nome do servidor System Center Virtual Machine Manager (VMM) que gere as máquinas virtuais. |
A atividade Encerrar VM gera o resultado descrito na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Comentários |
---|---|---|---|
ID da VM | VMID | String | Especifica o ID exclusivo da máquina virtual que foi encerrada. O ID da VM de entrada e o ID da VM de saída são iguais, a menos que a atividade não tenha encontrado uma máquina virtual com um ID de VM que corresponda ao ID da VM de entrada. Nesse caso, o ID da VM de saída está definido como Nulo. |
Erros e exceções | Observações | Exemplo |
---|---|---|
A atividade Encerrar VM utiliza o serviço de controlo personalizado fornecido pelo Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida. | Nenhuma | Nenhuma |
Iniciar a atividade da VM
Esta atividade no Service Manager inicia uma máquina virtual parada ou em pausa.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | Nenhuma |
Propriedades
A atividade Iniciar VM utiliza as propriedades de entrada na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Continuar com o Erro | ContinueOnError | Booleano | N.º (A predefinição é Verdadeiro.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
Tem Erro | HasError | N/D | Especifica se a atividade tem um conjunto de erros. (Só de leitura) | |
Variável de Tarefa | JobVariable | String | No | Especifica que o progresso da tarefa é controlado e armazenado na variável com o nome deste parâmetro. |
Grupo de Gestão | GrupoGestão | String | No | O grupo de gestão no qual esta atividade será executada. Defina como localhost. (Só de leitura) |
PROTipID | PROTipID | GUID | No | Especifica o ID da sugestão de Desempenho e Otimização de Recursos (PRO) que acionou esta ação. Permite futuras auditorias de sugestões PRO. |
Executar De forma Assíncrona | RunAsynchronously | Booleano | N.º (A predefinição é Falso.) | Especifica que a tarefa é executada de forma assíncrona para que o controlo regresse imediatamente à shell de comandos. |
Servidor de Scripts | Destino | String | Yes | Especifica o nome DNS (Domain Name System) do servidor que executa a consola Service Manager. Não utilize localhost. |
Limite de Tempo do Script | TimeoutSeconds | Número inteiro | N.º (A predefinição é de 300 segundos.) | Especifica o número máximo de segundos para permitir a execução da atividade. |
ID da VM | VMID | String | Yes | Especifica o ID exclusivo da máquina virtual a iniciar. |
VMMServer | VMMServer | String | Yes | Especifica o nome do servidor System Center Virtual Machine Manager (VMM) que gere as máquinas virtuais. |
A atividade Iniciar VM gera o resultado descrito na tabela seguinte.
Nome a Apresentar | Nome Interno | Tipo | Comentários |
---|---|---|---|
ID da VM | VMID | String | Especifica o ID exclusivo da máquina virtual que foi iniciada. O ID da VM de entrada e o ID da VM de saída são iguais, a menos que a atividade não tenha encontrado uma máquina virtual com um ID de VM que corresponda ao ID da VM de entrada. Nesse caso, o ID da VM de saída está definido como Nulo. |
Erros e exceções | Observações | Exemplo |
---|---|---|
A atividade Iniciar VM utiliza o serviço de controlo personalizado fornecido pelo Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções, conforme adequado, se nenhuma das propriedades do script não puder ser resolvida. | Nenhuma | Nenhuma |
Guardar atividade de VM de Estado
Esta atividade no Service Manager guarda o estado de uma máquina virtual e, em seguida, para a máquina virtual.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | - A consola do Virtual Machine Manager e o Service Manager têm de estar ambos instalados no mesmo servidor. - Certifique-se de que a conta Service Manager Fluxo de Trabalho tem permissões suficientes para modificar grupos de segurança no Active Directory Domain Services (AD DS). |
Propriedades
A atividade Guardar VM do Estado utiliza as propriedades de entrada descritas na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Continuar com o Erro | ContinueOnError | Booleano | N.º (A predefinição é Verdadeiro.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
Tem Erro | HasError | N/D | Especifica se a atividade tem um conjunto de erros. (Só de leitura) | |
Variável de Tarefa | JobVariable | String | No | Especifica que o progresso da tarefa é controlado e armazenado na variável com o nome deste parâmetro. |
Grupo de Gestão | GrupoGestão | String | No | Especifica o grupo de gestão no qual esta atividade será executada. Defina como localhost. (Só de leitura) |
PROTipID | PROTipID | GUID | No | Especifica o ID da sugestão Desempenho e Otimização de Recursos (PRO) que acionou esta ação. Permite a auditoria futura de sugestões PRO. |
Executar De forma Assíncrona | RunAsynchronously | Booleano | N.º (A predefinição é Falso.) | Especifica que a tarefa é executada de forma assíncrona para que o controlo regresse imediatamente à shell de comandos. |
Servidor de Scripts | Destino | String | Yes | Especifica o nome DNS (Domain Name System) do servidor que executa a consola Service Manager. Não utilize localhost. |
Limite de Tempo do Script | TimeoutSeconds | Número inteiro | N.º (A predefinição é de 300 segundos.) | Especifica o número máximo de segundos para permitir a execução da atividade. |
ID da VM | VMID | String | Yes | Especifica o ID exclusivo da máquina virtual a guardar. |
Servidor VMM | VMMServer | String | Yes | Especifica o nome do servidor System Center Virtual Machine Manager (VMM) que gere as máquinas virtuais. |
A atividade Guardar VM de Estado gera o resultado descrito na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Comentários |
---|---|---|---|
ID da VM | VMID | String | Especifica o ID exclusivo da máquina virtual que foi guardada. O ID da VM de entrada e o ID da VM de saída são iguais, a menos que a atividade não tenha encontrado uma máquina virtual com um ID de VM que corresponda ao ID da VM de entrada. Nesse caso, o ID da VM de saída está definido como Nulo. |
Erros e exceções | Observações | Exemplo |
---|---|---|
A atividade Guardar VM de Estado utiliza o serviço de controlo personalizado fornecido pelo Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida. | Nenhuma | Nenhuma |
Atividades de script
Utilize uma atividade de script no Service Manager para executar um script como parte de um fluxo de trabalho.
As atividades de script são executadas como um processo separado dos fluxos de trabalho. No entanto, também são executadas no contexto de segurança da conta de Fluxo de Trabalho do Service Manager.
A Ferramenta de Criação de Service Manager fornece as seguintes três atividades de script predefinidas no subgrupo Atividades de Script Genérico do grupo Atividades de Script no painel Caixa de Ferramentas Atividades.
Atividade do Script de Comandos
Esta atividade executa um script de linha de comandos como parte de um fluxo de trabalho do Windows Workflow Foundation (WF).
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | Nenhuma |
Propriedades
A atividade Script de Comando utiliza as propriedades de entrada descritas na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Continuar com o Erro | ContinueOnError | Booleano | N.º (A predefinição é Verdadeiro.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
Tem Erro | HasError | N/D | Especifica se a atividade tem um conjunto de erros. (Só de leitura) | |
Grupo de Gestão | ManagementGroupName | String | No | Especifica o grupo de gestão ao qual o servidor de scripts pertence. Por predefinição, está definido como localhost. (Só de leitura) |
Parâmetros de Script | Parâmetros | Cadeia de dicionário,cadeia <> | Yes | Especifica os parâmetros da linha de comandos ou os pares switch/value a serem transmitidos para o script quando for executado. |
Corpo do Script | ScriptBody | String | Yes | Especifica o texto do próprio script. |
Servidor de Scripts | Destino | String | No | Especifica o nome do Sistema de Nomes de Domínio (DNS) do servidor que executa a consola do Service Manager. Não utilize localhost. |
Limite de Tempo do Script | TimeoutSeconds | Número inteiro | N.º (A predefinição é 300 segundos.) | Especifica o número máximo de segundos para permitir a execução do script. |
Erros e exceções | Observações | Exemplo |
---|---|---|
A atividade Script de Comandos utiliza o serviço de controlo personalizado fornecido pelo Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida. | Nenhuma | Nenhuma |
atividade script do Windows PowerShell
Esta atividade no Service Manager executa um script Windows PowerShell como parte de um fluxo de trabalho do Windows Workflow Foundation (WF).
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
A atividade script Windows PowerShell depende dos seguintes pré-requisitos no momento da conceção: - Windows PowerShell 2.0 |
Windows PowerShell 2.0 |
Propriedades
A atividade script Windows PowerShell utiliza as propriedades de entrada descritas na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Continuar com o Erro | ContinueOnError | Booleano | N.º (A predefinição é Verdadeiro.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
Tem Erro | HasError | N/D | Especifica se a atividade tem um conjunto de erros. (Só de leitura) | |
Grupo de Gestão | ManagementGroupName | String | No | Especifica o grupo de gestão ao qual o servidor de scripts pertence. Por predefinição, está definido como localhost. (Só de leitura) |
Parâmetros de Script | Parâmetros | Cadeia de dicionário,cadeia <> | Yes | Especifica o nome/lista de valores dos parâmetros a serem transmitidos para o script quando for executado. Pode definir valores de parâmetros para qualquer uma das seguintes referências do pacote de gestão: - $Target/...$ - $MPElement[...] - $Data/...$. $Data referências são resolvidas apenas no tempo de execução nos parâmetros (não no próprio script). Utilizar uma destas referências como o único valor para um parâmetro define esse parâmetro para a cadeia XML que representa o item de dados de entrada (de GetItemXML). |
Corpo do Script | ScriptBody | String | Yes | Especifica o texto do próprio script. |
Snap-ins | SnapIns | String | No | Listas Windows PowerShell snap-ins para pré-carregar para o espaço de execução. |
Servidor de Scripts | Destino | String | No | Especifica o nome do Sistema de Nomes de Domínio (DNS) do servidor que executa a consola do Service Manager. Não utilize localhost. |
Limite de Tempo do Script | TimeoutSeconds | Número inteiro | N.º (A predefinição é 300 segundos.) | Especifica o número máximo de segundos para permitir a execução do script. |
Erros e exceções | Observações | Exemplo |
---|---|---|
A atividade script de Windows PowerShell utiliza o serviço de controlo personalizado fornecido por Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida. | Para obter mais informações sobre Windows PowerShell, consulte Windows PowerShell. | Nenhuma |
Atividade de Script do VBScript
Esta atividade no Service Manager executa um script VBScript como parte de um fluxo de trabalho do Windows Workflow Foundation (WF).
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
A atividade script VBScript depende dos seguintes pré-requisitos no momento da conceção: Nenhum. |
Nenhuma |
Propriedades
A atividade Script VBScript utiliza as propriedades de entrada descritas na tabela seguinte.
Nome a Apresentar | Nome Interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Continuar com o Erro | ContinueOnError | Booleano | N.º (A predefinição é Verdadeiro.) | Determina se o fluxo de trabalho continua a ser executado se a atividade falhar. |
Tem Erro | HasError | N/D | Especifica se a atividade tem um conjunto de erros. (Só de leitura) | |
Grupo de Gestão | ManagementGroupName | String | No | Especifica o grupo de gestão ao qual o servidor de scripts pertence. (Por predefinição, está definido como localhost) (Só de leitura) |
Parâmetros de Script | Parâmetros | Cadeia de dicionário,cadeia <> | Yes | Fornece a lista dos comutadores padrão e quaisquer valores associados que este script utiliza quando é executado. |
Corpo do Script | ScriptBody | String | Yes | Especifica o texto do próprio script. |
Servidor de Scripts | Destino | String | No | Especifica o nome DNS (Domain Name System) do servidor que executa a consola Service Manager. Não utilize localhost. |
Limite de Tempo do Script | TimeoutSeconds | Número inteiro | N.º (A predefinição é de 300 segundos.) | Especifica o número máximo de segundos para permitir a execução do script. |
Erros e exceções | Observações | Exemplo |
---|---|---|
A atividade script VBScript utiliza o serviço de controlo personalizado fornecido por Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida. | Nenhuma | Nenhuma |
Atividades do Service Manager
Utilize Service Manager atividades no Service Manager para fazer Service Manager funções parte do fluxo de trabalho.
A Ferramenta de Criação de Service Manager fornece as quatro atividades de Service Manager predefinidas no grupo Atividades de SM no painel Caixa de Ferramentas Atividades.
Criar Atividade de incidentes
Esta atividade cria e preenche um incidente no Service Manager.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | Nenhuma |
Propriedades
A atividade Criar Incidente utiliza as propriedades de entrada listadas na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Comentários |
---|---|---|---|---|
ID do Incidente | IncidentID | String | Yes | Especifica o identificador exclusivo que é gerado para o objeto Incidente . |
Comentário do Registo de Ações | ActionLogComment | String | Yes | Especifica o comentário a incluir no registo de ações do objeto Incidente . |
Domínio de Utilizador Afetado | AffectedUserDomain | String | Yes | Especifica o nome do domínio DNS (Domain Name System) do utilizador primário que é afetado pelo incidente. |
Nome de Utilizador Afetado | AffectedUserName | String | Yes | Especifica o nome de utilizador do utilizador principal que é afetado pelo incidente. |
Categoria | Categoria | Número inteiro | Yes | Especifica o tipo de incidente, como Rede ou Impressão. O valor é o ID de enum. (Campo de dados de categoria -enum ) |
Continuar com o Erro | ContinueOnError | Booleano | N.º (A predefinição é verdadeira.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
Impacto | Impacto | Número inteiro | Yes | Especifica o impacto do incidente no utilizador ou utilizadores afetados. O valor é o ID de enum. (Impact -enum data type) |
Origem | Origem | Número inteiro | No | Especifica a origem de informações sobre o incidente, como Telefone ou E-mail. O valor é o ID de enum. (Campo de tipo de dados de origem -enum ) |
Resumo | Resumo | String | Yes | Especifica o texto de resumo que descreve o incidente. |
Urgência | Urgência | Número inteiro | Yes | Especifica a urgência de resolver o incidente. O valor é o ID de enum. (Campo de tipo de dados Urgência -enum ) |
A atividade Criar Incidente gera o resultado descrito na tabela seguinte.
Nome | Tipo | Comentários |
---|---|---|
Incidente de SM | System.WorkItem.Incident | Devolve a instância da classe de incidentes construída. |
Erros e exceções | Observações | Exemplo |
---|---|---|
Nenhuma | Nenhuma | Nenhuma |
Obter Atividade de incidentes
Esta atividade obtém um ou mais incidentes no Service Manager.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | Nenhuma |
Propriedades
A atividade Obter Incidente utiliza as propriedades de entrada listadas na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Comentários |
---|---|---|---|---|
Domínio de Utilizador Afetado | AffectedUserDomain | String | No | Especifica o nome do domínio DNS (Domain Name System) do utilizador primário que é afetado pelo incidente. |
Nome de Utilizador Afetado | AffectedUserName | String | No | Especifica o nome de utilizador do utilizador principal que é afetado pelo incidente. |
Categoria | Categoria | Número inteiro | No | Especifica o tipo de incidente, como Rede ou Impressão. O valor é o ID de enum. (Campo de dados de categoria -enum ) |
Continuar com o Erro | ContinueOnError | Booleano | N.º (A predefinição é verdadeira.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
ID do Incidente | IncidentID | String | No | Especifica o identificador exclusivo que é gerado para o objeto de incidente. |
Tipo de Pesquisa | SearchType | Número inteiro? | No | Especifica o título do tipo de pesquisa que é utilizado com a atividade. |
Estado | Estado | Número inteiro | No | Especifica o estado do incidente. O valor é o ID de enum. (Estado - campo de dados de numeração ) |
Texto de Resumo | ResumoTexto | String | No | Especifica o texto de resumo que descreve o incidente. |
A atividade Obter Incidente gera o resultado descrito na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Comentários |
---|---|---|---|
Incidentes de SM | SMIncidents | Matriz de System.Workitem.Incident | Especifica uma matriz de objetos de incidentes. |
Erros e exceções | Observações | Exemplo |
---|---|---|
Nenhuma | A atividade Obter Incidente tem o seu próprio validador para efetuar a validação de erros nas propriedades de entrada. | Nenhuma |
Atualizar atividade de Incidentes
Esta atividade no Service Manager guarda as alterações de propriedade num incidente de Service Manager.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | Nenhuma |
Propriedades
A atividade Atualizar Incidente utiliza as propriedades de entrada descritas na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
Comentário do Registo de Ações | ActionLogComment | String | No | Especifica um comentário a incluir no registo de ações do objeto Incidente. |
Domínio de Utilizador Afetado | AffectedUserDomain | String | No | Especifica o nome do domínio DNS (Domain Name System) do utilizador primário que é afetado pelo incidente. |
Nome de Utilizador Afetado | AffectedUserName | String | No | Especifica o nome de utilizador do utilizador principal que é afetado pelo incidente. |
Categoria | Categoria | Número inteiro | No | Especifica o tipo de incidente, como Rede ou Impressão. O valor é o ID de enum. (Tipo de dados de categoria -enum ) |
Continuar com o Erro | ContinueOnError | Booleano | N.º (A predefinição é verdadeira.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
Impacto | Impacto | Número inteiro | No | Especifica o impacto do incidente no utilizador ou utilizadores afetados. O valor é o ID de enum. (Impact -enum data type) |
Origem | Origem | Número inteiro | No | Especifica a origem de informações sobre o incidente, como Telefone ou E-mail. O valor é o ID de enum. (Tipo de dados de origem -enum ) |
Incidente de Service Manager | SMIncident | System.Workitem.Incident | No | A instância da classe de incidentes construída a ser atualizada. |
Estado | Estado | Número inteiro | No | Especifica o estado do incidente que gerou a atividade. O valor é o ID de enum. (Tipo de dados de estado -enum ) |
Resumo | Resumo | String | No | Especifica o texto de resumo que descreve o incidente. |
Urgência | Urgência | Número inteiro | No | Especifica a urgência de resolver o incidente. O valor é o ID de enum. (Campo de tipo de dados Urgência -enum ) |
A atividade Atualizar Incidente gera o resultado descrito na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Description |
---|---|---|---|
Incidente de SM | SMIncident | System.WorkItem.Incident | Devolve uma atualização da instância da classe de incidentes. O Incidente de SM de entrada e o Incidente de SM de saída são iguais, a menos que a atividade não tenha encontrado o Incidente de SM. Nesse caso, o incidente de SM de saída está definido como Nulo. |
Erros e exceções | Observações | Exemplo |
---|---|---|
Nenhuma | Nenhuma | Nenhuma |
Definir o Estado da Atividade como Atividade concluída
Esta atividade atualiza o estado de uma atividade automatizada no Service Manager.
Pré-requisitos de tempo de conceção | Pré-requisitos de tempo de execução |
---|---|
Nenhuma | Nenhum. |
Propriedades
A atividade Definir Estado da Atividade como Concluída utiliza as propriedades de entrada descritas na tabela seguinte.
Nome a apresentar | Nome interno | Tipo | Necessário | Descrição |
---|---|---|---|---|
ID da Atividade | ActivityID | String | Yes | Especifica o identificador de um objeto de atividade automatizada Service Manager. |
Erros e exceções | Observações | Exemplo |
---|---|---|
Nenhuma | Quando estiver a utilizar esta atividade num fluxo de trabalho que é acionado por uma atividade automatizada Service Manager, introduza $Data/BaseManagedEntityId$ como o valor desta propriedade. Este valor aplica-se à atividade Definir Estado da Atividade para Concluída na atividade automatizada que acionou a execução do fluxo de trabalho. | Nenhuma |