Compartilhar via


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 WF personalizadas 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 da fase 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 ComputerDomain fio Sim O nome de domínio DNS totalmente qualificado em que o computador está localizado (por exemplo, contoso.com).
Nome do Computador FullyQualifiedComputerName fio Sim O nome do computador.
Nome de Grupo FullyQualifiedGroupName fio Sim O nome do grupo Serviços de Domínio do 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: Verdadeiro se a adição for bem-sucedida; Falso se a adição 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 da fase 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 Domínio do Usuário fio Sim O FQDN (nome de domínio totalmente qualificado) do usuário.
Nome de usuário UserName fio Sim O nome de entrada do usuário.
Nome de Grupo FullyQualifiedGroupName fio 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 da Exibição Nome interno Tipo Descrição
Saída Saída Booliano O resultado da operação: Verdadeiro se a adição for bem-sucedida, Falso se falhar.
Erros e exceções Comentários Exemplo
Nenhum Nenhum Nenhum

Atividades de Controle de Fluxo

Use atividades de fluxo de controle para fornecer estrutura (ramificações, loops ou atrasos de temporizador) para o 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 Atividades.

Atividade de atraso

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 da fase 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 Interno Especifica um manipulador para inicializar a propriedade TimeoutDuration .
TimeoutDuration TimeoutDuration 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 as atividades Get Incident ou Get Virtual Machine 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:

    1. Defina Current Item como a propriedade Current Item da atividade Loop Container da atividade ForEach. Se essa atividade for a primeira atividade na atividade Para Cada Loop, o Item Atual será definido automaticamente.

    2. Defina o valor da propriedade Property to Bind como o valor da propriedade da atividade atual que usa o valor Current Item.

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 Windows PowerShell Script.

  • 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 da fase 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 Dados InputCollection Matriz/Objeto N/A 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.
Current Item CurrentItem Objeto N/A 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 relacionado às 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 se repete.

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 da fase 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 da fase 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 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 da fase 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 fio 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: Pesquisar 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/A 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 fio 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 fio Não Especifica o grupo de gerenciamento no qual essa atividade será executada. Defina como localhost. (Somente leitura)
Servidor de Script Destino fio 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 TimeoutSeconds 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 fio Obrigatório se o Conjunto de parâmetros for VMHostGroup Obrigatório 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 fio 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 fio 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
IDs de VM VMIDList Matriz de cadeias de caracteres Especifica a lista de IDs de máquinas virtuais cujos nomes correspondem total ou parcialmente à sequência 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

Atividade Move 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 da fase 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/A 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 fio Não Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por esse parâmetro.
Grupo de gerenciamento ManagementGroup fio Não Especifica o grupo de gerenciamento no qual essa atividade será executada. Defina como localhost. (Somente leitura)
Caminho Caminho fio 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 futura auditoria de dicas PRO.
Executar de forma assíncrona RunAsynchronously 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 fio 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 TimeoutSeconds 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 do Windows Server 2008 Cluster Migration para a transferência de uma máquina virtual que está em um estado salvo para um host, mesmo que o cluster dê 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 fio Sim Especifica o nome do host de manutenção para o qual a máquina virtual será movida.
ID da VM VMID fio Sim Especifica a ID exclusiva da máquina virtual a ser movida.
Servidor VMM VMMServer fio 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 fio 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. No caso de uma máquina virtual implantada em um host do Virtual Server, o serviço convidado de virtualização será chamado de Adições de Máquina Virtual.

Pré-requisitos da fase 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/A Especifica se a atividade tem um conjunto de erros. (Somente leitura)
Variável de trabalho Variável de trabalho fio Não Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por esse parâmetro.
Grupo de gerenciamento ManagementGroup fio 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 futura auditoria de dicas PRO.
Executar de forma assíncrona RunAsynchronously 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 fio 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 TimeoutSeconds 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 fio Sim Especifica o identificador exclusivo da máquina virtual que será desligada.
VMMServer VMMServer fio 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 que é descrita na tabela abaixo.

Nome de exibição Nome interno Tipo Comentários
ID da VM VMID fio 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 da fase 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/A Especifica se a atividade tem um conjunto de erros. (Somente leitura)
Variável de trabalho Variável de trabalho fio Não Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por esse parâmetro.
Grupo de gerenciamento ManagementGroup fio 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 futura auditoria de dicas PRO.
Executar de forma assíncrona RunAsynchronously 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 fio 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 TimeoutSeconds 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 fio Sim Especifica a ID exclusiva da máquina virtual a ser iniciada.
VMMServer VMMServer fio 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 da Exibição Nome interno Tipo Comentários
ID da VM VMID fio 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

Atividade Save State VM

Essa atividade no Service Manager salva o estado de uma máquina virtual e, em seguida, interrompe a máquina virtual.

Pré-requisitos da fase 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 Estado da 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/A Especifica se a atividade tem um conjunto de erros. (Somente leitura)
Variável de trabalho Variável de trabalho fio Não Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por esse parâmetro.
Grupo de gerenciamento ManagementGroup fio 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 futura auditoria de dicas PRO.
Executar de forma assíncrona RunAsynchronously 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 fio 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 TimeoutSeconds 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 fio Sim Especifica a ID exclusiva da máquina virtual a ser salva.
Servidor VMM VMMServer fio Sim Especifica o nome do servidor do System Center Virtual Machine Manager (VMM) que gerencia as máquinas virtuais.

A atividade Salvar Estado da VM gera a saída que é descrita na tabela a seguir.

Nome de exibição Nome interno Tipo Comentários
ID da VM VMID fio 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 Save State VM 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 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 seguintes três atividades de script padrão no subgrupo Atividades de Script Genéricas do grupo Atividades de Script no painel Caixa de Ferramentas de Atividades.

Atividade Command Script

Essa atividade executa um script de linha de comando como parte de um fluxo de trabalho do Windows Workflow Foundation (WF).

Pré-requisitos da fase 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/A Especifica se a atividade tem um conjunto de erros. (Somente leitura)
Grupo de gerenciamento NomeDoGrupoDeGestão fio 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 Dictionary <string,string> Sim Especifica opções de linha de comando ou pares de opções/valor a serem passadas para o script quando ele é executado.
Corpo do script ScriptBody fio Sim Especifica o texto do próprio script.
Servidor de Script Destino fio 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 TimeoutSeconds 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 da fase de design Pré-requisitos de tempo de execução
A atividade Windows PowerShell Script depende dos seguintes pré-requisitos em tempo de projeto:
– 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/A Especifica se a atividade tem um conjunto de erros. (Somente leitura)
Grupo de gerenciamento NomeDoGrupoDeGestão fio 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 Dictionary <string,string> Sim Especifica a lista de parâmetros com seus respectivos valores a serem passados para o script ao ser executado.

Você pode definir valores de parâmetro para qualquer uma das seguintes referências de pacote de gerenciamento:

- $Target/...$
- $MPElement[...]
- $Data/...$. As referências de $Data são resolvidas somente durante a 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 ScriptBody fio Sim Especifica o texto do próprio script.
Snap-ins SnapIns fio Não Lista os snap-ins do Windows PowerShell para carregar automaticamente no runspace.
Servidor de Script Destino fio 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 TimeoutSeconds 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 VBScript Script

Essa atividade no Service Manager executa um script VBScript como parte de um fluxo de trabalho do Windows Workflow Foundation (WF).

Pré-requisitos da fase de design Pré-requisitos de tempo de execução
A atividade VBScript Script depende dos seguintes pré-requisitos no momento do design:
Nenhum.
Nenhum

Propriedades

A atividade Script VBScript usa as propriedades de entrada descritas na tabela a seguir.

Nome da 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/A Especifica se a atividade tem um conjunto de erros. (Somente leitura)
Grupo de gerenciamento NomeDoGrupoDeGestão fio 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 Dictionary <string,string> Sim Fornece a lista dos comutadores padrão e todos os valores associados que esse script usa quando é executado.
Corpo do script ScriptBody fio Sim Especifica o texto do próprio script.
Servidor de Script Destino fio 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 TimeoutSeconds 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 a seguir do Service Manager no grupo Atividades de SM no painel Caixa de ferramentas Atividades.

Atividade Create Incident

Essa atividade cria e popula um incidente no Service Manager.

Pré-requisitos da fase 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ória Comentários
ID do Incidente ID do incidente fio Sim Especifica o identificador exclusivo que é gerado para o objeto Incident.
Comentário do histórico de ações Comentário do ActionLog fio Sim Especifica o comentário a ser incluído no log de ações do objeto Incident .
Domínio do usuário afetado DomínioDoUsuárioAfetado fio 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 fio 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 enum. (Campo de dados de categoria -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 Sim Especifica o impacto do incidente no usuário ou usuários afetados. O valor é o ID de enum. (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 enum. (campo de tipo de dados Source -enum)
Resumo Resumo fio 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 enum. (campo de tipo de dados Urgency -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 da classe de incidente construída.
Erros e exceções Comentários Exemplo
Nenhum Nenhum Nenhum

Atividade Get Incident

Essa atividade recupera um ou mais incidentes no Service Manager.

Pré-requisitos da fase 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ória Comentários
Domínio do usuário afetado DomínioDoUsuárioAfetado fio 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 fio 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 enum. (Campo de dados de categoria -enum )
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 fio 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.
Estado Estado Inteiro Não Especifica o status do incidente. O valor é o ID de enum. (Campo de dados Status -enum )
Texto resumido Texto do resumo fio Não Especifica o texto de resumo que descreve o incidente.

A atividade Get Incident gera a saída que é descrita na tabela a seguir.

Nome de exibição Nome interno Tipo Comentários
Incidentes de 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

Atividade Update Incident

Esta atividade no Service Manager salva alterações de propriedade em um incidente do Service Manager.

Pré-requisitos da fase 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 histórico de ações Comentário do ActionLog fio Não Especifica um comentário a ser incluído no log de ações do objeto Incident.
Domínio do usuário afetado DomínioDoUsuárioAfetado fio 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 fio 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 enum. (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 enum. (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 enum. (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.
Estado Estado Inteiro Não Especifica o status do incidente que gerou a atividade. O valor é o ID de enum. (tipo de dados Status -enum)
Resumo Resumo fio 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 enum. (campo de tipo de dados Urgency -enum)

A atividade Atualização de 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 da fase 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 IdentificadorDaAtividade fio 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