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