Referência de atividade de fluxo de trabalho da Ferramenta de Criação do Service Manager
Este artigo fornece diretrizes para desenvolvedores de TI (tecnologia da informação) para que eles possam criar atividades personalizadas do Windows Workflow Foundation (WF) que os profissionais de TI podem usar para criar fluxos de trabalho do WF específicos para seus processos de TI. As atividades personalizadas do WF estendem a Biblioteca de Atividades — as atividades que são distribuídas com a Ferramenta de Criação do Service Manager. A seção "Referência de atividades de fluxo de trabalho" deste documento fornece detalhes das atividades padrão do WF na Biblioteca de Atividades. Essas informações visam a ajudar os desenvolvedores (ou profissionais de TI que atuem como desenvolvedores) a criar atividades personalizados do WF, conforme a necessidade.
Para obter informações sobre como usar atividades e fluxos de trabalho do WF com Service Manager, consulte Automatizando processos de TI com fluxos de trabalho.
Atividades do Active Directory
Use as atividades do AD DS (Active Directory Domain Services) para tornar as funções do Active Directory parte do seu fluxo de trabalho no Service Manager.
A Ferramenta de Criação do Service Manager fornece duas atividades padrão do Service Manager no grupo Atividades do Active Directory no painel Caixa de Ferramentas de Atividades. As seções deste artigo descrevem essas atividades.
Adicionar computador do AD DS a uma atividade de grupo
Essa atividade adiciona um computador a um grupo de segurança nos Serviços de Domínio Active Directory (AD DS) no Service Manager. O computador e o grupo devem pertencer ao mesmo domínio e todos os contêineres no domínio são pesquisados.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | Ao usar essa atividade, verifique se a conta de fluxo de trabalho do Service Manager tem permissões suficientes para modificar grupos de segurança no AD DS. |
Propriedades
A atividade Adicionar Computador AD DS ao Grupo usa as propriedades de entrada descritas na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Domínio do computador | Domínio do computador | String | Sim | O nome de domínio DNS totalmente qualificado em que o computador está localizado (por exemplo, contoso.com). |
| Nome do Computador | Nome_do_ComputadorTotalmente Qualificado | String | Sim | O nome do computador. |
| Nome de Grupo | Nome do Grupo Totalmente Qualificado | String | Sim | O nome do grupo Serviços de Domínio Active Directory. |
A atividade Adicionar Computador do AD DS ao Grupo gera a saída descrita na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Descrição |
|---|---|---|---|
| Saída | Saída | Booliano | O resultado da operação: True se a adição for bem-sucedida; Falso se falhar. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| Nenhum | Nenhum | Nenhum |
Adicionar usuário do AD DS à atividade de grupo
Essa atividade adiciona um usuário a um grupo de segurança nos Serviços de Domínio Active Directory (AD DS) no Service Manager. O usuário e o grupo devem pertencer ao mesmo domínio e todos os contêineres no domínio são pesquisados.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | Ao usar essa atividade, verifique se a conta de fluxo de trabalho do Service Manager tem permissões suficientes para modificar grupos de segurança no AD DS. |
Propriedades
A atividade Adicionar Usuário do AD DS ao Grupo usa as propriedades de entrada listadas na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Domínio do Usuário | UserDomain | String | Sim | O FQDN (nome de domínio totalmente qualificado) do usuário. |
| Nome de usuário | UserName | String | Sim | O nome de entrada do usuário. |
| Nome de Grupo | Nome do Grupo Totalmente Qualificado | String | Sim | O FQDN do grupo. |
A atividade Adicionar Usuário do AD DS ao Grupo gera a saída descrita na tabela a seguir.
| Nome para Exibição | Nome interno | Tipo | Descrição |
|---|---|---|---|
| Saída | Saída | Booliano | O resultado da operação: True se a adição for bem-sucedida, False se falhar. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| Nenhum | Nenhum | Nenhum |
Atividades de fluxo de controle
Use atividades de fluxo de controle para fornecer estrutura — ramificações, loops ou atrasos de temporizador — para seu fluxo de trabalho no Service Manager.
A Ferramenta de Criação fornece quatro atividades de fluxo de controle padrão no grupo Fluxo de Controle no painel Caixa de Ferramentas de Atividades.
Atrasar atividade
Essa atividade introduz um atraso entre as atividades em um fluxo de trabalho no Service Manager. A atividade Delay é derivada da classe DelayActivity do Microsoft .NET Framework.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | Nenhum |
Propriedades
A atividade Delay usa as propriedades de entrada listadas na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Inicializar TimeoutDuration | InitializeTimeoutDuration | Interna | Especifica um manipulador para inicializar a propriedade TimeoutDuration . | |
| Duração do tempo limite | Duração do tempo limite | Timespan | Sim | Duração do atraso. |
A atividade Delay não produz uma propriedade de saída.
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| Nenhum | Para obter mais informações sobre essa atividade, consulte Classe DelayActivity na biblioteca de classes do .NET Framework. | Nenhum |
Atividade For Each Loop
A atividade For Each Loop usa como entrada uma matriz (coleção) de objetos e repete o conjunto de atividades dentro do loop para cada objeto na coleção. Por exemplo, se a coleção de entrada tiver cinco objetos, o loop iterará cinco vezes. Se a coleção estiver vazia, o loop não será iterado. Não há limite superior para o número de objetos na coleção. A atividade For Each Loop sempre é executada no computador no qual o fluxo de trabalho é executado.
A atividade For Each Loop é uma atividade composta com dois contêineres para atividades:
Contêiner de entrada: essa atividade configura o loop e define a coleção de entrada. Você pode usar a atividade Obter Incidente ou Obter Máquina Virtual nessa função.
Contêiner de loop: Nomeado ForEachChildActivity, essa atividade contém as atividades de loop. A maioria das atividades do Windows Workflow Foundation (WF) que você coloca nesse contêiner tem duas propriedades adicionais: Item Atual e Propriedade a Ser Associada. Para cada atividade dentro do contêiner de loop, defina essas propriedades da seguinte maneira:
Defina Item Atual como a propriedade Item Atual da atividade Contêiner de Loop da atividade ForEach . Se essa atividade for a primeira atividade na atividade Para cada loop, o Item atual será definido automaticamente.
Defina o valor da propriedade Property to Bind como o valor da propriedade da atividade atual que usa o valor do Item Atual.
Dois tipos de atividades não obtêm as propriedades Current Item e Property to Bind e, portanto, não podem usar os objetos na coleção de entrada:
Atividades de script, como a atividade de script do Windows PowerShell.
Atividades personalizadas ou outras atividades que não herdam da classe WorkflowActivityBase . Essas atividades incluem as atividades baseadas na classe base Activity, como atividades nativas do Visual Studio.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | Nenhum |
Propriedades
A atividade For Each Loop usa as propriedades de entrada descritas na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Coleta de entrada | Coleção de Entrada | Matriz/Objeto | N/D | Uma coleção de objetos a serem passados, um de cada vez, para as atividades dentro da atividade For Each Loop . Se a atividade que reside no contêiner de entrada produzir uma matriz de objetos como sua propriedade de saída, a Coleção de Entrada será definida automaticamente como essa propriedade. Para exibir o valor atual dessa propriedade, clique com o botão direito do mouse no contêiner de loop e selecione Propriedades. |
| Item atual | Item atual | Objeto | N/D | Um índice em Input Collection que as atividades dentro do loop podem usar como uma propriedade de entrada. Para a primeira atividade no contêiner de loop, essa propriedade é definida automaticamente. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| A atividade For Each Loop usa o serviço de acompanhamento personalizado fornecido pelo Service Manager para registrar 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 com as atividades filho, o fluxo de trabalho será encerrado. - Se ocorrer algum erro nas atividades filho, o fluxo de trabalho será encerrado, a menos que ContinueOnError=true. - Se alguma das propriedades de entrada for nula. A atividade não é iterada. Cada atividade dentro da atividade For Each Loop deve gravar seus próprios erros ou exceções no serviço de rastreamento personalizado. A atividade For Each Loop não faz isso sozinha. |
Nenhum | Nenhum |
Atividade IfElse
Essa atividade controla a sequência de atividades em um fluxo de trabalho com base em uma condição booleana (Verdadeiro/Falso). Você pode usar o resultado de uma atividade anterior, como uma atividade de script, para a condição.
A atividade IfElse é uma atividade do Visual Studio que usa regras e condições. Para obter mais informações sobre como usar regras e condições no Windows Workflow Foundation (WF), consulte Tutorial: Usar regras e condições no WF na Biblioteca MSDN.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | Nenhum |
Propriedades
Nenhum.
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| Nenhum | Para obter mais informações sobre a atividade IfElse , consulte Classe IfElseActivity na Biblioteca de Classes do .NET Framework 4. | Nenhum |
Atividade paralela
Essa atividade bifurca a sequência de atividades em duas sequências simultâneas de atividades. A atividade Parallel é uma atividade do Visual Studio. Para obter mais informações sobre a classe ParallelActivity , consulte Classe ParallelActivity na Biblioteca de Classes do .NET Framework.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | Nenhum |
Propriedades
Nenhum.
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| Nenhum | Nenhum | Nenhum |
Atividades do Virtual Machine Manager
Use atividades de gerenciamento de máquina virtual no Service Manager para criar fluxos de trabalho que permitam criar e atualizar máquinas virtuais. As atividades de gerenciamento de máquina virtual dão suporte ao System Center Virtual Machine Manager.
A Ferramenta de Criação do Service Manager fornece as cinco atividades de gerenciamento de máquina virtual padrão a seguir no grupo Atividades do VMM no painel Caixa de Ferramentas de Atividades.
Obter atividade da VM
Essa atividade no Service Manager recupera uma lista de uma ou mais IDs de máquina virtual de uma biblioteca do Virtual Machine Manager (VMM).
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | - O console do Virtual Machine Manager e o Service Manager devem estar instalados no mesmo servidor. - Verifique se a conta de fluxo de trabalho do Service Manager tem permissões suficientes para modificar grupos de segurança nos Serviços de Domínio Active Directory (AD DS). - O console do Virtual Machine Manager e o Service Manager devem estar instalados no mesmo servidor. - Verifique se a conta de fluxo de trabalho do Service Manager tem permissões suficientes para modificar grupos de segurança nos Serviços de Domínio Active Directory (AD DS). |
Propriedades
A atividade Obter VM usa as propriedades de entrada na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Conjunto de parâmetros | Conjunto de parâmetros | String | Não; o padrão é Conexão. | Especifica um subconjunto de parâmetros organizados para uma finalidade específica. Para a atividade Obter VM , você pode selecionar um dos seguintes conjuntos de parâmetros: - Todos: pesquise todas as máquinas virtuais disponíveis. - ID: Procure uma máquina virtual com uma ID conhecida. - Conexão: pesquise máquinas virtuais conectadas ao servidor VMM (Virtual Machine Manager) designado pela propriedade VMMServer . - VMHostGroup: procure máquinas virtuais conectadas ao host da máquina virtual designado pela propriedade Host da VM. |
| Continuar em caso de erro | ContinueOnError | Booliano | Não. (A configuração padrão é True.) | 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. (Somente leitura) | |
| Tudo | Tudo | Booliano | Não. (A configuração padrão é True.) | Disponível se o Conjunto de parâmetros for Todos. Se estiver definido como True, a atividade Obter VM retornará uma lista das IDs de máquina virtual de todas as máquinas virtuais disponíveis. |
| ID | ID | String | Obrigatório se o conjunto de parâmetros for ID. | Disponível se o Conjunto de parâmetros for ID. Se estiver definida como True, a atividade Obter VM retornará uma lista das IDs de máquina virtual de todas as máquinas virtuais cujas IDs de máquina virtual correspondem a todo ou parte do valor de ID especificado. |
| Grupo de gerenciamento | ManagementGroup | String | Não | Especifica o grupo de gerenciamento no qual essa atividade será executada. Defina como localhost. (Somente leitura) |
| Servidor de Script | Destino | String | Sim | Especifica o nome DNS (Sistema de Nomes de Domínio) do servidor que executa o console do Service Manager. Não use localhost. |
| Limite de tempo do script | Segundos de tempo limite | Inteiro | Não. (A configuração padrão é 300 segundos.) | Especifica o número máximo de segundos para permitir que a atividade seja executada. |
| VM Host | VMHost | String | Obrigatório se o conjunto de parâmetros for VMHostGroup | Disponível se o conjunto de parâmetros for VMHostGroup. Se esse conjunto de parâmetros for selecionado, a atividade Obter VM retornará uma lista das IDs de máquina virtual de todas as máquinas virtuais em execução no host especificado. |
| Nome da VM | VMName | String | Não | Especifica o nome ou parte de um nome da máquina virtual a ser pesquisada. Se a cadeia de caracteres fizer parte de um nome, a atividade recuperará as IDs de todas as máquinas virtuais que contêm a cadeia de caracteres. |
| VMMServer | VMMServer | String | Sim | Especifica o nome do servidor do System Center Virtual Machine Manager (VMM) que gerencia as máquinas virtuais. |
A atividade Obter VM gera a saída descrita na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Comentários |
|---|---|---|---|
| VM IDs | VMIDList | Matriz das cadeias de caracteres | Especifica a lista das IDs de máquinas virtuais com nomes que correspondem a toda ou parte da cadeia de caracteres Nome da VM . |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| A atividade Obter VM usa o serviço de acompanhamento personalizado fornecido pelo Service Manager para registrar erros e exceções quando a atividade é executada. A atividade gerará erros ou exceções conforme apropriado se qualquer uma das propriedades do script não puder ser resolvida. | Nenhum | Nenhum |
Mover atividade da VM
Essa atividade no Service Manager move uma máquina virtual da Biblioteca do Virtual Machine Manager (VMM) para um host de manutenção.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | - O console do Virtual Machine Manager e o Service Manager devem estar instalados no mesmo servidor. - Verifique se a conta de fluxo de trabalho do Service Manager tem permissões suficientes para modificar grupos de segurança nos Serviços de Domínio Active Directory (AD DS). |
Propriedades
A atividade Mover VM usa as propriedades de entrada na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Continuar em caso de erro | ContinueOnError | Booliano | Não. (A configuração padrão é True.) | 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. (Somente leitura) | |
| Bloquear LM se o host estiver ocupado | BlockLMIfHostBusy | Booliano | Não. (A configuração padrão é False.) | Bloqueia a repetição de uma migração dinâmica do Hyper-V se a migração falhar porque o host de origem ou o host de destino já está participando de outra migração dinâmica. |
| Grupo de trabalho | JobGroup | Guid (cadeia de caracteres) | Não | Especifica um identificador para uma série de comandos que serão executados como um conjunto. |
| Variável de trabalho | Variável de trabalho | String | Não | Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por esse parâmetro. |
| Grupo de gerenciamento | ManagementGroup | String | Não | Especifica o grupo de gerenciamento no qual essa atividade será executada. Defina como localhost. (Somente leitura) |
| Caminho | Caminho | String | Não | Especifica o destino da máquina virtual no host de manutenção. |
| PROTipID | PROTipID | Guid | Não | Especifica a ID da dica de Otimização de Desempenho e Recursos (PRO) que acionou essa ação. Permite auditoria futura de pontas PRO. |
| Executar de forma assíncrona | ExecutarDe forma assíncrona | Booliano | Não. (A configuração padrão é False.) | Especifica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente. |
| Servidor de Script | Destino | String | Sim | Especifica o nome DNS (Sistema de Nomes de Domínio) do servidor que executa o console do Service Manager. Não use localhost. |
| Limite de tempo do script | Segundos de tempo limite | Inteiro | Não. (A configuração padrão é 300 segundos.) | Especifica o número máximo de segundos para permitir que a atividade seja executada. |
| Iniciar VM no destino | StartVMOnTarget | Booliano | Não. (A configuração padrão é False.) | Especifica que uma máquina virtual é iniciada assim que atinge seu host de destino. |
| Usar cluster | UseCluster | Booliano | Não. (A configuração padrão é False.) | Força o uso da Migração de Cluster do Windows Server 2008 para a transferência de uma máquina virtual que está em um estado salvo para um host, mesmo que o cluster ofereça suporte à migração dinâmica do Hyper-V. |
| Usar LAN | UseLan | Booliano | Não. (A configuração padrão é False.) | Força uma transferência pela rede local (LAN) mesmo que um mecanismo de transferência mais rápido, como uma transferência de rede de área de armazenamento (SAN), esteja disponível. |
| VM Host | VMHostName | String | Sim | Especifica o nome do host de manutenção para o qual a máquina virtual será movida. |
| ID da VM | VMID | String | Sim | Especifica a ID exclusiva da máquina virtual a ser movida. |
| Servidor VMM | VMMServer | String | Sim | Especifica o nome do servidor do System Center Virtual Machine Manager (VMM) que gerencia as máquinas virtuais. |
A atividade Mover VM gera a saída descrita na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Comentários |
|---|---|---|---|
| ID da VM | VMID | String | Especifica a ID exclusiva da máquina virtual que foi movida. A ID da VM de entrada e a ID da VM de saída são iguais, a menos que a atividade não tenha conseguido encontrar uma máquina virtual com uma ID de VM que corresponda à ID da VM de entrada. Nesse caso, a ID da VM de saída é definida como Nula. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| A atividade Mover VM usa o serviço de acompanhamento personalizado fornecido pelo Service Manager para registrar erros e exceções quando a atividade é executada. A atividade gerará erros ou exceções conforme apropriado se qualquer uma das propriedades do script não puder ser resolvida. | Nenhum | Nenhum |
Desligar a atividade da VM
Essa atividade no Service Manager desliga o sistema operacional convidado em uma máquina virtual.
Você pode usar a atividade Desligar VM em uma máquina virtual em um host baseado no Windows (um host Hyper-V ou um host do Virtual Server) somente se os serviços convidados de virtualização estiverem instalados na máquina virtual. Para uma máquina virtual implantada em um host Hyper-V, o serviço convidado de virtualização é chamado de Componentes de Integração. Para uma máquina virtual implantada em um host do Virtual Server, o serviço convidado de virtualização é chamado de Adições de Máquina Virtual.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | - O console do Virtual Machine Manager e o Service Manager devem estar instalados no mesmo servidor. - Verifique se a conta de fluxo de trabalho do Service Manager tem permissões suficientes para modificar grupos de segurança nos Serviços de Domínio Active Directory (AD DS). |
Propriedades
A atividade Desligar VM usa as propriedades de entrada descritas na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Continuar em caso de erro | ContinueOnError | Booliano | Não. (A configuração padrão é True.) | 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. (Somente leitura) | |
| Variável de trabalho | Variável de trabalho | String | Não | Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por esse parâmetro. |
| Grupo de gerenciamento | ManagementGroup | String | Não | Especifica o grupo de gerenciamento no qual essa atividade será executada. Defina como localhost. (Somente leitura) |
| PROTipID | PROTipID | Guid | Não | Especifica a ID da dica de Otimização de Desempenho e Recursos (PRO) que acionou essa ação. Permite auditoria futura de pontas PRO. |
| Executar de forma assíncrona | ExecutarDe forma assíncrona | Booliano | Não. (A configuração padrão é False.) | Especifica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente. |
| Servidor de Script | Destino | String | Sim | Especifica o nome DNS (Sistema de Nomes de Domínio) do servidor que executa o console do Service Manager. Não use Localhost. |
| Limite de tempo do script | Segundos de tempo limite | Inteiro | Não. (A configuração padrão é 300 segundos.) | Especifica o número máximo de segundos para permitir que a atividade seja executada. |
| ID da VM | VMID | String | Sim | Especifica a ID exclusiva da máquina virtual a ser desligada. |
| VMMServer | VMMServer | String | Sim | Especifica o nome do servidor do System Center Virtual Machine Manager (VMM) que gerencia as máquinas virtuais. |
A atividade Desligar VM gera a saída descrita na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Comentários |
|---|---|---|---|
| ID da VM | VMID | String | Especifica a ID exclusiva da máquina virtual que foi desligada. A ID da VM de entrada e a ID da VM de saída são iguais, a menos que a atividade não tenha conseguido encontrar uma máquina virtual com uma ID de VM que corresponda à ID da VM de entrada. Nesse caso, a ID da VM de saída é definida como Nula. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| A atividade Desligar VM usa o serviço de acompanhamento personalizado fornecido pelo Service Manager para registrar erros e exceções quando a atividade é executada. A atividade gerará erros ou exceções conforme apropriado se qualquer uma das propriedades do script não puder ser resolvida. | Nenhum | Nenhum |
Iniciar atividade de VM
Essa atividade no Service Manager inicia uma máquina virtual interrompida ou pausada.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | Nenhum |
Propriedades
A atividade Iniciar VM usa as propriedades de entrada na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Continuar em caso de erro | ContinueOnError | Booliano | Não. (A configuração padrão é True.) | 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. (Somente leitura) | |
| Variável de trabalho | Variável de trabalho | String | Não | Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por esse parâmetro. |
| Grupo de gerenciamento | ManagementGroup | String | Não | O grupo de gerenciamento no qual essa atividade será executada. Defina como localhost. (Somente leitura) |
| PROTipID | PROTipID | Guid | Não | Especifica a ID da dica de Otimização de Desempenho e Recursos (PRO) que acionou essa ação. Permite auditoria futura de pontas PRO. |
| Executar de forma assíncrona | ExecutarDe forma assíncrona | Booliano | Não. (A configuração padrão é False.) | Especifica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente. |
| Servidor de Script | Destino | String | Sim | Especifica o nome DNS (Sistema de Nomes de Domínio) do servidor que executa o console do Service Manager. Não use localhost. |
| Limite de tempo do script | Segundos de tempo limite | Inteiro | Não. (A configuração padrão é 300 segundos.) | Especifica o número máximo de segundos para permitir que a atividade seja executada. |
| ID da VM | VMID | String | Sim | Especifica a ID exclusiva da máquina virtual a ser iniciada. |
| VMMServer | VMMServer | String | Sim | Especifica o nome do servidor do System Center Virtual Machine Manager (VMM) que gerencia as máquinas virtuais. |
A atividade Iniciar VM gera a saída descrita na tabela a seguir.
| Nome para Exibição | Nome interno | Tipo | Comentários |
|---|---|---|---|
| ID da VM | VMID | String | Especifica a ID exclusiva da máquina virtual que foi iniciada. A ID da VM de entrada e a ID da VM de saída são iguais, a menos que a atividade não tenha conseguido encontrar uma máquina virtual com uma ID de VM que corresponda à ID da VM de entrada. Nesse caso, a ID da VM de saída é definida como Nula. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| A atividade Iniciar VM usa o serviço de acompanhamento personalizado fornecido pelo Service Manager para registrar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções, conforme apropriado, se qualquer uma das propriedades do script não puder ser resolvida. | Nenhum | Nenhum |
Salvar atividade de VM de estado
Essa atividade no Service Manager salva o estado de uma máquina virtual e, em seguida, interrompe a máquina virtual.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | - O console do Virtual Machine Manager e o Service Manager devem estar instalados no mesmo servidor. - Verifique se a conta de fluxo de trabalho do Service Manager tem permissões suficientes para modificar grupos de segurança nos Serviços de Domínio Active Directory (AD DS). |
Propriedades
A atividade Salvar VM de Estado usa as propriedades de entrada descritas na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Continuar em caso de erro | ContinueOnError | Booliano | Não. (A configuração padrão é True.) | 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. (Somente leitura) | |
| Variável de trabalho | Variável de trabalho | String | Não | Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por esse parâmetro. |
| Grupo de gerenciamento | ManagementGroup | String | Não | Especifica o grupo de gerenciamento no qual essa atividade será executada. Defina como localhost. (Somente leitura) |
| PROTipID | PROTipID | Guid | Não | Especifica a ID da dica de Otimização de Desempenho e Recursos (PRO) que acionou essa ação. Permite auditoria futura de pontas PRO. |
| Executar de forma assíncrona | ExecutarDe forma assíncrona | Booliano | Não. (A configuração padrão é False.) | Especifica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente. |
| Servidor de Script | Destino | String | Sim | Especifica o nome DNS (Sistema de Nomes de Domínio) do servidor que executa o console do Service Manager. Não use localhost. |
| Limite de tempo do script | Segundos de tempo limite | Inteiro | Não. (A configuração padrão é 300 segundos.) | Especifica o número máximo de segundos para permitir que a atividade seja executada. |
| ID da VM | VMID | String | Sim | Especifica a ID exclusiva da máquina virtual a ser salva. |
| Servidor VMM | VMMServer | String | Sim | Especifica o nome do servidor do System Center Virtual Machine Manager (VMM) que gerencia as máquinas virtuais. |
A atividade Salvar VM de Estado gera a saída descrita na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Comentários |
|---|---|---|---|
| ID da VM | VMID | String | Especifica a ID exclusiva da máquina virtual que foi salva. A ID da VM de entrada e a ID da VM de saída são iguais, a menos que a atividade não tenha conseguido encontrar uma máquina virtual com uma ID de VM que corresponda à ID da VM de entrada. Nesse caso, a ID da VM de saída é definida como Nula. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| A atividade de VM de Estado de Salvamento usa o serviço de acompanhamento personalizado fornecido pelo Service Manager para registrar erros e exceções quando a atividade é executada. A atividade gerará erros ou exceções conforme apropriado se qualquer uma das propriedades do script não puder ser resolvida. | Nenhum | Nenhum |
Atividades de script
Use uma atividade de script no Service Manager para executar um script como parte de um fluxo de trabalho.
Atividades de script são executadas em um processo separado dos fluxos de trabalho; porém, também são executadas no contexto de segurança da conta Fluxo de Trabalho do Service Manager.
A Ferramenta de Criação do Service Manager fornece as três atividades de script padrão a seguir no subgrupo Atividades de Script Genéricas do grupo Atividades de Script no painel Caixa de Ferramentas de Atividades.
Atividade de script de comando
Essa atividade executa um script de linha de comando como parte de um fluxo de trabalho do Windows Workflow Foundation (WF).
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | Nenhum |
Propriedades
A atividade Script de Comando usa as propriedades de entrada descritas na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Continuar em caso de erro | ContinueOnError | Booliano | Não. (A configuração padrão é True.) | 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. (Somente leitura) | |
| Grupo de gerenciamento | ManagementGroupName | String | Não | Especifica o grupo de gerenciamento ao qual o servidor de script pertence. Por padrão, isso é definido como localhost. (Somente leitura) |
| Parâmetros de script | Parâmetros | Cadeia de caracteres do dicionário <, cadeia de caracteres> | Sim | Especifica opções de linha de comando ou pares de chave/valor a serem passados para o script quando ele for executado. |
| Corpo do script | Corpo do script | String | Sim | Especifica o texto do próprio script. |
| Servidor de Script | Destino | String | Não | Especifica o nome DNS (Sistema de Nomes de Domínio) do servidor que executa o console do Service Manager. Não use localhost. |
| Limite de tempo do script | Segundos de tempo limite | Inteiro | Não. (A configuração padrão é 300 segundos.) | Especifica o número máximo de segundos para permitir que o script seja executado. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| A atividade Script de Comando usa o serviço de acompanhamento personalizado fornecido pelo Service Manager para registrar erros e exceções quando a atividade é executada. A atividade gerará erros ou exceções conforme apropriado se qualquer uma das propriedades do script não puder ser resolvida. | Nenhum | Nenhum |
Atividade de script do Windows PowerShell
Essa atividade no Service Manager executa um script do Windows PowerShell como parte de um fluxo de trabalho do Windows Workflow Foundation (WF).
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| A atividade de Script do Windows PowerShell depende dos seguintes pré-requisitos em tempo de design: - Windows PowerShell 2.0 |
Windows PowerShell 2.0 |
Propriedades
A atividade Script do Windows PowerShell usa as propriedades de entrada descritas na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Continuar em caso de erro | ContinueOnError | Booliano | Não. (A configuração padrão é True.) | 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. (Somente leitura) | |
| Grupo de gerenciamento | ManagementGroupName | String | Não | Especifica o grupo de gerenciamento ao qual o servidor de script pertence. Por padrão, isso é definido como localhost. (Somente leitura) |
| Parâmetros de script | Parâmetros | Cadeia de caracteres do dicionário <, cadeia de caracteres> | Sim | Especifica a lista de parâmetros/valores de nome/valor a serem passados para o script quando ele é executado. Você pode definir valores de parâmetro para qualquer uma das seguintes referências de pacote de gerenciamento: - $Target/...$ - $MPElement[...] - $Data/...$. $Data referências são resolvidas apenas em tempo de execução nos parâmetros (não no próprio script). Usar uma dessas referências como o único valor para um parâmetro define esse parâmetro como a cadeia de caracteres XML que representa o item de dados de entrada (de GetItemXML). |
| Corpo do script | Corpo do script | String | Sim | Especifica o texto do próprio script. |
| Snap-ins | SnapIns | String | Não | Lista os snap-ins do Windows PowerShell para pré-carregar no runspace. |
| Servidor de Script | Destino | String | Não | Especifica o nome DNS (Sistema de Nomes de Domínio) do servidor que executa o console do Service Manager. Não use localhost. |
| Limite de tempo do script | Segundos de tempo limite | Inteiro | Não. (A configuração padrão é 300 segundos.) | Especifica o número máximo de segundos para permitir que o script seja executado. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| A atividade de Script do Windows PowerShell usa o serviço de controle personalizado fornecido pelo Service Manager para registrar erros e exceções quando a atividade é executada. A atividade gerará erros ou exceções conforme apropriado se qualquer uma das propriedades do script não puder ser resolvida. | Para obter mais informações sobre o Windows PowerShell, consulte Windows PowerShell. | Nenhum |
Atividade de script VBScript
Essa 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 design | Pré-requisitos de tempo de execução |
|---|---|
| A atividade Script VBScript depende dos seguintes pré-requisitos em tempo de design: Nenhum. |
Nenhum |
Propriedades
A atividade Script VBScript usa as propriedades de entrada descritas na tabela a seguir.
| Nome para Exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Continuar em caso de erro | ContinueOnError | Booliano | Não. (A configuração padrão é True.) | 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. (Somente leitura) | |
| Grupo de gerenciamento | ManagementGroupName | String | Não | Especifica o grupo de gerenciamento ao qual o servidor de script pertence. (Por padrão, isso é definido como localhost) (Somente leitura) |
| Parâmetros de script | Parâmetros | Cadeia de caracteres do dicionário <, cadeia de caracteres> | Sim | Fornece a lista dos comutadores padrão e todos os valores associados que esse script usa quando é executado. |
| Corpo do script | Corpo do script | String | Sim | Especifica o texto do próprio script. |
| Servidor de Script | Destino | String | Não | Especifica o nome DNS (Sistema de Nomes de Domínio) do servidor que executa o console do Service Manager. Não use localhost. |
| Limite de tempo do script | Segundos de tempo limite | Inteiro | Não. (A configuração padrão é 300 segundos.) | Especifica o número máximo de segundos para permitir que o script seja executado. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| A atividade Script VBScript usa o serviço de rastreamento personalizado fornecido pelo Service Manager para registrar erros e exceções quando a atividade é executada. A atividade gerará erros ou exceções conforme apropriado se qualquer uma das propriedades do script não puder ser resolvida. | Nenhum | Nenhum |
Atividades do Service Manager
Use as atividades do Service Manager no Service Manager para tornar as funções do Service Manager parte do seu fluxo de trabalho.
A Ferramenta de Criação do Service Manager fornece as quatro atividades padrão do Service Manager a seguir no grupo Atividades do SM no painel Caixa de Ferramentas de Atividades.
Criar atividade de incidente
Essa atividade cria e preenche um incidente no Service Manager.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | Nenhum |
Propriedades
A atividade Criar Incidente usa as propriedades de entrada listadas na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatório | Comentários |
|---|---|---|---|---|
| ID do Incidente | ID do incidente | String | Sim | Especifica o identificador exclusivo gerado para o objeto Incident . |
| Comentário do registro de ações | Comentário do ActionLogComment | String | Sim | Especifica o comentário a ser incluído no log de ações do objeto Incident . |
| Domínio do usuário afetado | AffectedUserDomain | String | Sim | Especifica o nome do domínio DNS (Sistema de Nomes de Domínio) do usuário principal afetado pelo incidente. |
| Nome de usuário afetado | Nome de usuário afetado | String | Sim | Especifica o nome de usuário do usuário principal afetado pelo incidente. |
| Categoria | Categoria | Inteiro | Sim | Especifica o tipo de incidente, como Rede ou Impressão. O valor é o ID de enumeração. (Campo de dados de categoria -enumeração ) |
| Continuar em caso de erro | ContinueOnError | Booliano | Não. (A configuração padrão é true.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
| Impacto | Impacto | Inteiro | Sim | Especifica o impacto do incidente no usuário ou usuários afetados. O valor é o ID de enumeração. (Tipo de dados Impact -enum ) |
| Origem | Origem | Inteiro | Não | Especifica a fonte de informações sobre o incidente, como Telefone ou Email. O valor é o ID de enumeração. (Campo de tipo de dados Source -enum ) |
| Resumo | Resumo | String | Sim | Especifica o texto de resumo que descreve o incidente. |
| Urgência | Urgência | Inteiro | Sim | Especifica a urgência de resolver o incidente. O valor é o ID de enumeração. (Campo de tipo de dados de urgência -enum ) |
A atividade Criar Incidente gera a saída descrita na tabela a seguir.
| Nome | Tipo | Comentários |
|---|---|---|
| Incidente SM | System.WorkItem.Incident | Retorna a instância de classe de incidente construída. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| Nenhum | Nenhum | Nenhum |
Obter atividade de incidente
Essa atividade recupera um ou mais incidentes no Service Manager.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | Nenhum |
Propriedades
A atividade Get Incident usa as propriedades de entrada listadas na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatório | Comentários |
|---|---|---|---|---|
| Domínio do usuário afetado | AffectedUserDomain | String | Não | Especifica o nome do domínio DNS (Sistema de Nomes de Domínio) do usuário principal afetado pelo incidente. |
| Nome de usuário afetado | Nome de usuário afetado | String | Não | Especifica o nome de usuário do usuário principal afetado pelo incidente. |
| Categoria | Categoria | Inteiro | Não | Especifica o tipo de incidente, como Rede ou Impressão. O valor é o ID de enumeração. (Campo de dados de categoria -enumeração ) |
| Continuar em caso de erro | ContinueOnError | Booliano | Não. (O padrão é true.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
| ID do Incidente | ID do incidente | String | Não | Especifica o identificador exclusivo gerado para o objeto de incidente. |
| Tipo de pesquisa | Tipo de pesquisa | Inteiro | Não | Especifica o título do tipo de pesquisa usado com a atividade. |
| Status | Status | Inteiro | Não | Especifica o status do incidente. O valor é o ID de enumeração. (Campo de dados Status -enum ) |
| Texto resumido | Texto do resumo | String | Não | Especifica o texto de resumo que descreve o incidente. |
A atividade Obter Incidente gera a saída descrita na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Comentários |
|---|---|---|---|
| Incidentes SM | SMIncidents | Matriz de System.Workitem.Incident | Especifica uma matriz de objetos incidentes. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| Nenhum | A atividade Get Incident tem seu próprio validador para executar a validação de erros nas propriedades de entrada. | Nenhum |
Atualizar atividade de incidente
Essa atividade no Service Manager salva as alterações de propriedade em um incidente do Service Manager.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | Nenhum |
Propriedades
A atividade Atualizar Incidente usa as propriedades de entrada descritas na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| Comentário do registro de ações | Comentário do ActionLogComment | String | Não | Especifica um comentário a ser incluído no log de ações do objeto Incident. |
| Domínio do usuário afetado | AffectedUserDomain | String | Não | Especifica o nome do domínio DNS (Sistema de Nomes de Domínio) do usuário principal afetado pelo incidente. |
| Nome de usuário afetado | Nome de usuário afetado | String | Não | Especifica o nome de usuário do usuário principal afetado pelo incidente. |
| Categoria | Categoria | Inteiro | Não | Especifica o tipo de incidente, como Rede ou Impressão. O valor é o ID de enumeração. (Tipo de dados category -enum ) |
| Continuar em caso de erro | ContinueOnError | Booliano | Não. (A configuração padrão é true.) | Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar. |
| Impacto | Impacto | Inteiro | Não | Especifica o impacto do incidente no usuário ou usuários afetados. O valor é o ID de enumeração. (Tipo de dados Impact -enum ) |
| Origem | Origem | Inteiro | Não | Especifica a fonte de informações sobre o incidente, como Telefone ou Email. O valor é o ID de enumeração. (Tipo de dados Source -enum ) |
| Incidente do Service Manager | SMIncident | System.Workitem.Incident | Não | A instância de classe de incidente construída a ser atualizada. |
| Status | Status | Inteiro | Não | Especifica o status do incidente que gerou a atividade. O valor é o ID de enumeração. (Tipo de dados Status -enum ) |
| Resumo | Resumo | String | Não | Especifica o texto de resumo que descreve o incidente. |
| Urgência | Urgência | Inteiro | Não | Especifica a urgência de resolver o incidente. O valor é o ID de enumeração. (Campo de tipo de dados de urgência -enum ) |
A atividade Atualizar Incidente gera a saída descrita na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Descrição |
|---|---|---|---|
| Incidente SM | SMIncident | System.WorkItem.Incident | Retorna uma atualização da instância da classe de incidente. O Incidente SM de entrada e o Incidente SM de saída são iguais, a menos que a atividade não tenha encontrado o Incidente SM. Nesse caso, a saída SM Incident é definida como Null. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| Nenhum | Nenhum | Nenhum |
Definir Status da atividade como Atividade concluída
Essa atividade atualiza o status de uma atividade automatizada no Service Manager.
| Pré-requisitos de tempo de design | Pré-requisitos de tempo de execução |
|---|---|
| Nenhum | Nenhum. |
Propriedades
A atividade Definir Status da Atividade como Concluído usa as propriedades de entrada descritas na tabela a seguir.
| Nome de exibição | Nome interno | Tipo | Obrigatória | Descrição |
|---|---|---|---|---|
| ID da atividade | ActivityID | String | Sim | Especifica o identificador de um objeto de atividade automatizada do Service Manager. |
| Erros e exceções | Comentários | Exemplo |
|---|---|---|
| Nenhum | Quando você estiver usando essa atividade em um fluxo de trabalho disparado por uma atividade automatizada do Service Manager, insira $Data/BaseManagedEntityId$ como o valor dessa propriedade. Esse valor se aplica à atividade Definir Status da Atividade como Concluída na atividade automatizada que acionou a execução do fluxo de trabalho. | Nenhum |