referência de atividade do fluxo de trabalho da Ferramenta de Criação de Service Manager

Importante

Esta versão do Service Manager chegou ao fim do suporte. Recomendamos que atualize para o Service Manager 2022.

Este artigo fornece orientações para programadores de tecnologias de informação (TI) para que possam criar atividades personalizadas do Windows Workflow Foundation (WF) que os profissionais de TI podem utilizar para criar fluxos de trabalho WF específicos dos respetivos processos de TI. As atividades WF personalizadas expandem a Biblioteca de Atividades , as atividades que são distribuídas com a Ferramenta de Criação Service Manager. A secção Referência de Atividades de Fluxos de Trabalho deste documento fornece detalhes sobre as atividades do WF predefinidas na Biblioteca de Atividades. Esta informação destina-se a ajudar os programadores (ou profissionais de TI que estão a agir como programadores) a criar atividades do WF personalizadas, conforme necessário.

Para obter informações sobre como utilizar atividades WF e fluxos de trabalho WF com Service Manager, veja Automatizar Processos de TI com Fluxos de Trabalho.

Atividades do Active Directory

Utilize as atividades Active Directory Domain Services (AD DS) para tornar as funções do Active Directory parte do fluxo de trabalho no Service Manager.

A Ferramenta de Criação de Service Manager fornece duas atividades de Service Manager predefinidas no grupo Atividades do Active Directory no painel Caixa de Ferramentas Atividades. As secções neste artigo descrevem estas atividades.

Adicionar Computador do AD DS a uma atividade de Grupo

Esta atividade adiciona um computador a um grupo de segurança no Active Directory Domain Services (AD DS) no Service Manager. O computador e o grupo têm de pertencer ao mesmo domínio e todos os contentores no domínio são pesquisados.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	Quando utilizar esta atividade, certifique-se de que a conta Service Manager Fluxo de Trabalho tem permissões suficientes para modificar grupos de segurança no AD DS.

Propriedades

A atividade Adicionar Computador AD DS ao Grupo utiliza as propriedades de entrada descritas na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
Domínio do Computador	ComputerDomain	String	Yes	O nome de domínio DNS completamente qualificado onde o computador está localizado (por exemplo, contoso.com).
Nome do Computador	Completamente QualificadoComputerName	String	Yes	O nome do computador.
Nome do Grupo	FullyQualifiedGroupName	String	Yes	O nome do grupo Active Directory Domain Services.

A atividade Adicionar Computador do AD DS ao Grupo gera o resultado descrito na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Description
Saída	Saída	Booleano	O resultado da operação: Verdadeiro se a adição tiver sido efetuada com êxito; Falso se tiver falhado.

Erros e exceções	Observações	Exemplo
Nenhuma	Nenhuma	Nenhuma

Adicionar a atividade Utilizador do AD DS ao Grupo

Esta atividade adiciona um utilizador a um grupo de segurança no Active Directory Domain Services (AD DS) no Service Manager. O utilizador e o grupo têm de pertencer ao mesmo domínio e todos os contentores no domínio são pesquisados.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	Quando utilizar esta atividade, certifique-se de que a conta Service Manager Fluxo de Trabalho tem permissões suficientes para modificar grupos de segurança no AD DS.

Propriedades

A atividade Adicionar Utilizador do AD DS ao Grupo utiliza as propriedades de entrada listadas na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
Domínio do Utilizador	UserDomain	String	Yes	O nome de domínio completamente qualificado (FQDN) do utilizador.
Nome de Utilizador	Nome de Utilizador	String	Yes	O nome de início de sessão do utilizador.
Nome do Grupo	FullyQualifiedGroupName	String	Yes	O FQDN do grupo.

A atividade Adicionar Utilizador do AD DS ao Grupo gera o resultado descrito na tabela seguinte.

Nome a Apresentar	Nome Interno	Tipo	Description
Saída	Saída	Booleano	O resultado da operação: Verdadeiro se a adição tiver sido efetuada com êxito, Falso se tiver falhado.

Erros e exceções	Observações	Exemplo
Nenhuma	Nenhuma	Nenhuma

Atividades do Fluxo de Controlo

Utilize atividades de fluxo de controlo para fornecer estrutura (ramos, ciclos ou atrasos de temporizador) para o fluxo de trabalho no Service Manager.

A Ferramenta de Criação fornece quatro atividades de fluxo de controlo predefinidas no grupo Fluxo de Controlo no painel Caixa de Ferramentas Atividades .

Atividade de atraso

Esta atividade introduz um atraso entre as atividades num fluxo de trabalho no Service Manager. A atividade Atraso é derivada da classe DelayActivity da Microsoft .NET Framework.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	Nenhuma

Propriedades

A atividade Atraso utiliza as propriedades de entrada listadas na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
Inicializar TimeoutDuration	InitializeTimeoutDuration		Interno	Especifica um processador para inicializar a propriedade TimeoutDuration .
Tempo LimiteDuração	Tempo LimiteDuração	Timespan	Yes	Duração do atraso.

A atividade Atraso não produz uma propriedade de saída.

Erros e exceções	Observações	Exemplo
Nenhuma	Para obter mais informações sobre esta atividade, veja DelayActivity Class (Classe DelayActivity) na Biblioteca de Classes .NET Framework.	Nenhuma

Para a atividade Cada Ciclo

A atividade For Each Loop utiliza como entrada uma matriz (coleção) de objetos e repete o conjunto de atividades dentro do ciclo para cada objeto na coleção. Por exemplo, se a coleção de entrada tiver cinco objetos, o ciclo itera cinco vezes. Se a coleção estiver vazia, o ciclo não itera. Não existe um limite superior para o número de objetos na coleção. A atividade Para Cada Ciclo é sempre executada no computador no qual o fluxo de trabalho é executado.

A atividade For Each Loop é uma atividade composta com dois contentores para atividades:

• Contentor de Entrada: esta atividade configura o ciclo e define a coleção de entrada. Pode utilizar a atividade Obter Incidente ou Obter Máquina Virtual nesta função.

• Contentor de Ciclo: com o nome ForEachChildActivity, esta atividade contém as atividades de ciclo. A maioria das atividades do Windows Workflow Foundation (WF) que coloca neste contentor têm duas propriedades adicionais: Item Atual e Propriedade para Vincular. Para cada atividade no contentor de ciclo, defina estas propriedades da seguinte forma:

  1. Defina Item Atual para a propriedade Item Atual da atividade Contentor de Ciclo da atividade ForEach . Se esta atividade for a primeira atividade na atividade Para Cada Ciclo , o Item Atual é definido automaticamente.

  2. Defina o valor da propriedade Propriedade como Vincular para o valor da propriedade da atividade atual que utiliza o valor Item Atual .

Dois tipos de atividades não obtêm as propriedades Item e Propriedade Atualpara Vincular e, por conseguinte, não podem utilizar os objetos na coleção de entrada:

• Atividades de script, como a atividade script Windows PowerShell.

• Atividades personalizadas ou outras atividades que não herdam da classe WorkflowActivityBase . Essas atividades incluem as atividades baseadas na classe Base de atividades , como atividades nativas do Visual Studio.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	Nenhuma

Propriedades

A atividade For Each Loop utiliza as propriedades de entrada descritas na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
Coleção de Entrada	InputCollection	Matriz/Objeto	N/D	Uma coleção de objetos a transmitir, um de cada vez, às atividades na atividade For Each Loop . Se a atividade que reside no contentor de entrada produzir uma matriz de objetos como propriedade de saída, a Coleção de Entrada é definida automaticamente para essa propriedade. Para ver o valor atual desta propriedade, clique com o botão direito do rato no contentor de ciclo e selecione Propriedades.
Item Atual	CurrentItem	Objeto	N/D	Um índice na Coleção de Entrada que as atividades dentro do ciclo podem utilizar como uma propriedade de entrada. Para a primeira atividade no contentor de ciclo, esta propriedade é definida automaticamente.

Erros e exceções	Observações	Exemplo
A atividade For Each Loop utiliza o serviço de controlo personalizado fornecido por Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções nas seguintes condições: - Se ocorrer algum erro na atividade ForEachLoop e não estiver relacionado com as atividades subordinadas, o fluxo de trabalho termina. - Se ocorrer algum erro nas atividades subordinadas, o fluxo de trabalho termina a menos que ContinueOnError=true. - Se alguma das propriedades de entrada for nula. A atividade não itera. Cada atividade na atividade For Each Loop tem de escrever os seus próprios erros ou exceções no serviço de controlo personalizado. A atividade For Each Loop não o faz por si só.	Nenhuma	Nenhuma

Atividade IfElse

Esta atividade controla a sequência de atividades num fluxo de trabalho com base numa condição booleana (Verdadeiro/Falso). Pode utilizar o resultado de uma atividade anterior, como uma atividade de script, para a condição.

A atividade IfElse é uma atividade do Visual Studio que utiliza regras e condições. Para obter mais informações sobre como utilizar regras e condições no Windows Workflow Foundation (WF), consulte Tutorial: Utilizar Regras e Condições no WF na Biblioteca MSDN.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	Nenhuma

Propriedades

Nenhum.

Erros e exceções	Observações	Exemplo
Nenhuma	Para obter mais informações sobre a atividade IfElse, veja IfElseActivity Class (Classe IfElseActivity) na Biblioteca de Classes .NET Framework 4.	Nenhuma

Atividade paralela

Esta atividade forja a sequência de atividades em duas sequências simultâneas de atividades. A atividade Paralela é uma atividade do Visual Studio. Para obter mais informações sobre a classe ParallelActivity, veja ParallelActivity Class (Classe ParallelActivity) na Biblioteca de Classes .NET Framework.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	Nenhuma

Propriedades

Nenhum.

Erros e exceções	Observações	Exemplo
Nenhuma	Nenhuma	Nenhuma

Atividades do Virtual Machine Manager

Utilize atividades de gestão de máquinas virtuais no Service Manager para criar fluxos de trabalho que permitam criar e atualizar máquinas virtuais. As atividades de gestão de máquinas virtuais suportam System Center Virtual Machine Manager.

A Ferramenta de Criação de Service Manager fornece as seguintes cinco atividades de gestão de máquinas virtuais predefinidas no grupo Atividades do VMM no painel Caixa de Ferramentas Atividades.

Obter atividade de VM

Esta atividade no Service Manager obtém uma lista de um ou mais IDs de máquina virtual de uma Biblioteca do Virtual Machine Manager (VMM).

Pré-requisitos de tempo de conceção

Pré-requisitos de tempo de execução

Nenhuma

- A consola do Virtual Machine Manager e Service Manager têm de ser instaladas no mesmo servidor. - Certifique-se de que a conta Service Manager Fluxo de Trabalho tem permissões suficientes para modificar grupos de segurança no Active Directory Domain Services (AD DS). - A consola do Virtual Machine Manager e Service Manager têm de ser instaladas no mesmo servidor. - Certifique-se de que a conta Service Manager Fluxo de Trabalho tem permissões suficientes para modificar grupos de segurança no Active Directory Domain Services (AD DS).

Propriedades

A atividade Obter VM utiliza as propriedades de entrada na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
Conjunto de Parâmetros	ParameterSet	String	Não; a predefinição é Ligação.	Especifica um subconjunto de parâmetros organizados para uma finalidade específica. Para a atividade Obter VM , pode selecionar um dos seguintes conjuntos de parâmetros: - Tudo: Procure todas as máquinas virtuais disponíveis. - ID: Procure uma máquina virtual com um ID conhecido. - Ligação: Procure máquinas virtuais ligadas ao servidor do Virtual Machine Manager (VMM) designado pela propriedade VMMServer . - VMHostGroup: Procure máquinas virtuais ligadas ao anfitrião da máquina virtual que é designado pela propriedade Anfitrião da VM .
Continuar com o Erro	ContinueOnError	Booleano	N.º (A predefinição é Verdadeiro.)	Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar.
Tem Erro	HasError		N/D	Especifica se a atividade tem um conjunto de erros. (Só de leitura)
Todos	Todos	Booleano	N.º (A predefinição é Verdadeiro.)	Disponível se o Conjunto de Parâmetros for Tudo. Se estiver definido como Verdadeiro, a atividade Obter VM devolve uma lista dos IDs da máquina virtual de todas as máquinas virtuais disponíveis.
ID	ID	String	Necessário se o Conjunto de Parâmetros for ID.	Disponível se o Conjunto de Parâmetros for ID. Se estiver definido como Verdadeiro, a atividade Obter VM devolve uma lista dos IDs da máquina virtual de todas as máquinas virtuais cujos IDs de máquina virtual correspondem a todo ou a parte do valor de ID especificado.
Grupo de Gestão	GrupoGestão	String	No	Especifica o grupo de gestão no qual esta atividade será executada. Defina como localhost. (Só de leitura)
Servidor de Scripts	Destino	String	Yes	Especifica o nome DNS (Domain Name System) do servidor que executa a consola Service Manager. Não utilize localhost.
Limite de Tempo do Script	TimeoutSeconds	Número inteiro	N.º (A predefinição é de 300 segundos.)	Especifica o número máximo de segundos para permitir a execução da atividade.
Anfitrião de VM	VMHost	String	Necessário se o Conjunto de Parâmetros for VMHostGroup	Disponível se o Conjunto de Parâmetros for VMHostGroup. Se este conjunto de parâmetros estiver selecionado, a atividade Obter VM devolve uma lista dos IDs de máquina virtual de todas as máquinas virtuais em execução no anfitrião especificado.
Nome da VM	VMName	String	No	Especifica o nome ou parte de um nome da máquina virtual a procurar. Se a cadeia fizer parte de um nome, a atividade obtém os IDs de todas as máquinas virtuais que contêm a cadeia.
VMMServer	VMMServer	String	Yes	Especifica o nome do servidor System Center Virtual Machine Manager (VMM) que gere as máquinas virtuais.

A atividade Obter VM gera o resultado descrito na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Comentários
VM IDs	VMIDList	Matriz de cadeias	Especifica a lista dos IDs das máquinas virtuais com nomes que correspondem a todos ou a parte da cadeia nome da VM .

Erros e exceções	Observações	Exemplo
A atividade Obter VM utiliza o serviço de controlo personalizado fornecido pelo Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida.	Nenhuma	Nenhuma

Mover a atividade da VM

Esta atividade no Service Manager move uma máquina virtual da Biblioteca do Virtual Machine Manager (VMM) para um anfitrião de manutenção.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	- A consola do Virtual Machine Manager e o Service Manager têm de estar ambos instalados no mesmo servidor. - Certifique-se de que a conta de Fluxo de Trabalho do Service Manager tem permissões suficientes para modificar grupos de segurança no Active Directory Domain Services (AD DS).

Propriedades

A atividade Mover VM utiliza as propriedades de entrada na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
Continuar com o Erro	ContinueOnError	Booleano	N.º (A predefinição é Verdadeiro.)	Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar.
Tem Erro	HasError		N/D	Especifica se a atividade tem um conjunto de erros. (Só de leitura)
Bloquear O LM se o Anfitrião Estiver Ocupado	BlockLMIfHostBusy	Booleano	N.º (A predefinição é Falso.)	Bloqueia a repetição de uma migração em direto do Hyper-V se a migração tiver falhado porque o anfitrião de origem ou o anfitrião de destino já está a participar noutra migração em direto.
Grupo de Tarefas	Grupo de Tarefas	Guid (cadeia)	No	Especifica um identificador para uma série de comandos que serão executados como um conjunto.
Variável de Tarefa	JobVariable	String	No	Especifica que o progresso da tarefa é controlado e armazenado na variável denominada por este parâmetro.
Grupo de Gestão	GrupoGestão	String	No	Especifica o grupo de gestão no qual esta atividade será executada. Defina como localhost. (Só de leitura)
Caminho	Caminho	String	No	Especifica o destino da máquina virtual no anfitrião de manutenção.
PROTipID	PROTipID	GUID	No	Especifica o ID da sugestão de Desempenho e Otimização de Recursos (PRO) que acionou esta ação. Permite futuras auditorias de sugestões PRO.
Executar De forma Assíncrona	RunAsynchronously	Booleano	N.º (A predefinição é Falso.)	Especifica que a tarefa é executada de forma assíncrona para que o controlo regresse imediatamente à shell de comandos.
Servidor de Scripts	Destino	String	Yes	Especifica o nome DNS (Domain Name System) do servidor que executa a consola Service Manager. Não utilize localhost.
Limite de Tempo do Script	TimeoutSeconds	Número inteiro	N.º (A predefinição é de 300 segundos.)	Especifica o número máximo de segundos para permitir a execução da atividade.
Iniciar VM no Destino	StartVMOnTarget	Booleano	N.º (A predefinição é Falso.)	Especifica que uma máquina virtual é iniciada assim que chega ao anfitrião de destino.
Utilizar Cluster	UseCluster	Booleano	N.º (A predefinição é Falso.)	Força a utilização da Migração de Cluster do Windows Server 2008 para a transferência de uma máquina virtual que esteja num estado guardado para um anfitrião, mesmo que o cluster suporte a migração em direto do Hyper-V.
Utilizar LAN	UseLan	Booleano	N.º (A predefinição é Falso.)	Força uma transferência através da rede local (LAN), mesmo que esteja disponível um mecanismo de transferência mais rápido, como uma transferência de rede de armazenamento (SAN).
Anfitrião de VM	VMHostName	String	Yes	Especifica o nome do anfitrião de manutenção para o qual a máquina virtual será movida.
ID da VM	VMID	String	Yes	Especifica o ID exclusivo da máquina virtual a mover.
Servidor VMM	VMMServer	String	Yes	Especifica o nome do servidor System Center Virtual Machine Manager (VMM) que gere as máquinas virtuais.

A atividade Mover VM gera o resultado descrito na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Comentários
ID da VM	VMID	String	Especifica o ID exclusivo da máquina virtual que foi movida. O ID da VM de entrada e o ID da VM de saída são iguais, a menos que a atividade não tenha encontrado uma máquina virtual com um ID de VM que corresponda ao ID da VM de entrada. Nesse caso, o ID da VM de saída está definido como Nulo.

Erros e exceções	Observações	Exemplo
A atividade Mover VM utiliza o serviço de controlo personalizado fornecido pelo Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida.	Nenhuma	Nenhuma

Encerrar a atividade da VM

Esta atividade no Service Manager encerra o sistema operativo convidado numa máquina virtual.

Só pode utilizar a atividade Encerrar VM numa máquina virtual num anfitrião baseado no Windows (um anfitrião Hyper-V ou um anfitrião do Servidor Virtual) apenas se os serviços de convidado de virtualização estiverem instalados na máquina virtual. Para uma máquina virtual implementada num anfitrião Hyper-V, o serviço convidado de virtualização chama-se Componentes de Integração. Para uma máquina virtual que é implementada num anfitrião do Servidor Virtual, o serviço de convidado de virtualização chama-se Adições de Máquina Virtual.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	- A consola do Virtual Machine Manager e Service Manager têm de ser instaladas no mesmo servidor. - Certifique-se de que a conta Service Manager Fluxo de Trabalho tem permissões suficientes para modificar grupos de segurança no Active Directory Domain Services (AD DS).

Propriedades

A atividade De Encerramento da VM utiliza as propriedades de entrada descritas na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
Continuar com o Erro	ContinueOnError	Booleano	N.º (A predefinição é Verdadeiro.)	Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar.
Tem Erro	HasError		N/D	Especifica se a atividade tem um conjunto de erros. (Só de leitura)
Variável de Tarefa	JobVariable	String	No	Especifica que o progresso da tarefa é controlado e armazenado na variável com o nome deste parâmetro.
Grupo de Gestão	GrupoGestão	String	No	Especifica o grupo de gestão no qual esta atividade será executada. Defina como localhost. (Só de leitura)
PROTipID	PROTipID	GUID	No	Especifica o ID da sugestão de Desempenho e Otimização de Recursos (PRO) que acionou esta ação. Permite futuras auditorias de sugestões PRO.
Executar De forma Assíncrona	RunAsynchronously	Booleano	N.º (A predefinição é Falso.)	Especifica que a tarefa é executada de forma assíncrona para que o controlo regresse imediatamente à shell de comandos.
Servidor de Scripts	Destino	String	Yes	Especifica o nome do Sistema de Nomes de Domínio (DNS) do servidor que executa a consola do Service Manager. Não utilize Localhost.
Limite de Tempo do Script	TimeoutSeconds	Número inteiro	N.º (A predefinição é 300 segundos.)	Especifica o número máximo de segundos para permitir a execução da atividade.
ID da VM	VMID	String	Yes	Especifica o ID exclusivo da máquina virtual a encerrar.
VMMServer	VMMServer	String	Yes	Especifica o nome do servidor System Center Virtual Machine Manager (VMM) que gere as máquinas virtuais.

A atividade Encerrar VM gera o resultado descrito na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Comentários
ID da VM	VMID	String	Especifica o ID exclusivo da máquina virtual que foi encerrada. O ID da VM de entrada e o ID da VM de saída são iguais, a menos que a atividade não tenha encontrado uma máquina virtual com um ID de VM que corresponda ao ID da VM de entrada. Nesse caso, o ID da VM de saída está definido como Nulo.

Erros e exceções	Observações	Exemplo
A atividade Encerrar VM utiliza o serviço de controlo personalizado fornecido pelo Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida.	Nenhuma	Nenhuma

Iniciar a atividade da VM

Esta atividade no Service Manager inicia uma máquina virtual parada ou em pausa.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	Nenhuma

Propriedades

A atividade Iniciar VM utiliza as propriedades de entrada na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
Continuar com o Erro	ContinueOnError	Booleano	N.º (A predefinição é Verdadeiro.)	Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar.
Tem Erro	HasError		N/D	Especifica se a atividade tem um conjunto de erros. (Só de leitura)
Variável de Tarefa	JobVariable	String	No	Especifica que o progresso da tarefa é controlado e armazenado na variável com o nome deste parâmetro.
Grupo de Gestão	GrupoGestão	String	No	O grupo de gestão no qual esta atividade será executada. Defina como localhost. (Só de leitura)
PROTipID	PROTipID	GUID	No	Especifica o ID da sugestão de Desempenho e Otimização de Recursos (PRO) que acionou esta ação. Permite futuras auditorias de sugestões PRO.
Executar De forma Assíncrona	RunAsynchronously	Booleano	N.º (A predefinição é Falso.)	Especifica que a tarefa é executada de forma assíncrona para que o controlo regresse imediatamente à shell de comandos.
Servidor de Scripts	Destino	String	Yes	Especifica o nome DNS (Domain Name System) do servidor que executa a consola Service Manager. Não utilize localhost.
Limite de Tempo do Script	TimeoutSeconds	Número inteiro	N.º (A predefinição é de 300 segundos.)	Especifica o número máximo de segundos para permitir a execução da atividade.
ID da VM	VMID	String	Yes	Especifica o ID exclusivo da máquina virtual a iniciar.
VMMServer	VMMServer	String	Yes	Especifica o nome do servidor System Center Virtual Machine Manager (VMM) que gere as máquinas virtuais.

A atividade Iniciar VM gera o resultado descrito na tabela seguinte.

Nome a Apresentar	Nome Interno	Tipo	Comentários
ID da VM	VMID	String	Especifica o ID exclusivo da máquina virtual que foi iniciada. O ID da VM de entrada e o ID da VM de saída são iguais, a menos que a atividade não tenha encontrado uma máquina virtual com um ID de VM que corresponda ao ID da VM de entrada. Nesse caso, o ID da VM de saída está definido como Nulo.

Erros e exceções	Observações	Exemplo
A atividade Iniciar VM utiliza o serviço de controlo personalizado fornecido pelo Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções, conforme adequado, se nenhuma das propriedades do script não puder ser resolvida.	Nenhuma	Nenhuma

Guardar atividade de VM de Estado

Esta atividade no Service Manager guarda o estado de uma máquina virtual e, em seguida, para a máquina virtual.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	- A consola do Virtual Machine Manager e o Service Manager têm de estar ambos instalados no mesmo servidor. - Certifique-se de que a conta Service Manager Fluxo de Trabalho tem permissões suficientes para modificar grupos de segurança no Active Directory Domain Services (AD DS).

Propriedades

A atividade Guardar VM do Estado utiliza as propriedades de entrada descritas na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
Continuar com o Erro	ContinueOnError	Booleano	N.º (A predefinição é Verdadeiro.)	Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar.
Tem Erro	HasError		N/D	Especifica se a atividade tem um conjunto de erros. (Só de leitura)
Variável de Tarefa	JobVariable	String	No	Especifica que o progresso da tarefa é controlado e armazenado na variável com o nome deste parâmetro.
Grupo de Gestão	GrupoGestão	String	No	Especifica o grupo de gestão no qual esta atividade será executada. Defina como localhost. (Só de leitura)
PROTipID	PROTipID	GUID	No	Especifica o ID da sugestão Desempenho e Otimização de Recursos (PRO) que acionou esta ação. Permite a auditoria futura de sugestões PRO.
Executar De forma Assíncrona	RunAsynchronously	Booleano	N.º (A predefinição é Falso.)	Especifica que a tarefa é executada de forma assíncrona para que o controlo regresse imediatamente à shell de comandos.
Servidor de Scripts	Destino	String	Yes	Especifica o nome DNS (Domain Name System) do servidor que executa a consola Service Manager. Não utilize localhost.
Limite de Tempo do Script	TimeoutSeconds	Número inteiro	N.º (A predefinição é de 300 segundos.)	Especifica o número máximo de segundos para permitir a execução da atividade.
ID da VM	VMID	String	Yes	Especifica o ID exclusivo da máquina virtual a guardar.
Servidor VMM	VMMServer	String	Yes	Especifica o nome do servidor System Center Virtual Machine Manager (VMM) que gere as máquinas virtuais.

A atividade Guardar VM de Estado gera o resultado descrito na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Comentários
ID da VM	VMID	String	Especifica o ID exclusivo da máquina virtual que foi guardada. O ID da VM de entrada e o ID da VM de saída são iguais, a menos que a atividade não tenha encontrado uma máquina virtual com um ID de VM que corresponda ao ID da VM de entrada. Nesse caso, o ID da VM de saída está definido como Nulo.

Erros e exceções	Observações	Exemplo
A atividade Guardar VM de Estado utiliza o serviço de controlo personalizado fornecido pelo Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida.	Nenhuma	Nenhuma

Atividades de script

Utilize uma atividade de script no Service Manager para executar um script como parte de um fluxo de trabalho.

As atividades de script são executadas como um processo separado dos fluxos de trabalho. No entanto, também são executadas no contexto de segurança da conta de Fluxo de Trabalho do Service Manager.

A Ferramenta de Criação de Service Manager fornece as seguintes três atividades de script predefinidas no subgrupo Atividades de Script Genérico do grupo Atividades de Script no painel Caixa de Ferramentas Atividades.

Atividade do Script de Comandos

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

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	Nenhuma

Propriedades

A atividade Script de Comando utiliza as propriedades de entrada descritas na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
Continuar com o Erro	ContinueOnError	Booleano	N.º (A predefinição é Verdadeiro.)	Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar.
Tem Erro	HasError		N/D	Especifica se a atividade tem um conjunto de erros. (Só de leitura)
Grupo de Gestão	ManagementGroupName	String	No	Especifica o grupo de gestão ao qual o servidor de scripts pertence. Por predefinição, está definido como localhost. (Só de leitura)
Parâmetros de Script	Parâmetros	Cadeia de dicionário,cadeia <>	Yes	Especifica os parâmetros da linha de comandos ou os pares switch/value a serem transmitidos para o script quando for executado.
Corpo do Script	ScriptBody	String	Yes	Especifica o texto do próprio script.
Servidor de Scripts	Destino	String	No	Especifica o nome do Sistema de Nomes de Domínio (DNS) do servidor que executa a consola do Service Manager. Não utilize localhost.
Limite de Tempo do Script	TimeoutSeconds	Número inteiro	N.º (A predefinição é 300 segundos.)	Especifica o número máximo de segundos para permitir a execução do script.

Erros e exceções	Observações	Exemplo
A atividade Script de Comandos utiliza o serviço de controlo personalizado fornecido pelo Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida.	Nenhuma	Nenhuma

atividade script do Windows PowerShell

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

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
A atividade script Windows PowerShell depende dos seguintes pré-requisitos no momento da conceção: - Windows PowerShell 2.0	Windows PowerShell 2.0

Propriedades

A atividade script Windows PowerShell utiliza as propriedades de entrada descritas na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
Continuar com o Erro	ContinueOnError	Booleano	N.º (A predefinição é Verdadeiro.)	Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar.
Tem Erro	HasError		N/D	Especifica se a atividade tem um conjunto de erros. (Só de leitura)
Grupo de Gestão	ManagementGroupName	String	No	Especifica o grupo de gestão ao qual o servidor de scripts pertence. Por predefinição, está definido como localhost. (Só de leitura)
Parâmetros de Script	Parâmetros	Cadeia de dicionário,cadeia <>	Yes	Especifica o nome/lista de valores dos parâmetros a serem transmitidos para o script quando for executado. Pode definir valores de parâmetros para qualquer uma das seguintes referências do pacote de gestão: - $Target/...$ - $MPElement[...] - $Data/...$. $Data referências são resolvidas apenas no tempo de execução nos parâmetros (não no próprio script). Utilizar uma destas referências como o único valor para um parâmetro define esse parâmetro para a cadeia XML que representa o item de dados de entrada (de GetItemXML).
Corpo do Script	ScriptBody	String	Yes	Especifica o texto do próprio script.
Snap-ins	SnapIns	String	No	Listas Windows PowerShell snap-ins para pré-carregar para o espaço de execução.
Servidor de Scripts	Destino	String	No	Especifica o nome do Sistema de Nomes de Domínio (DNS) do servidor que executa a consola do Service Manager. Não utilize localhost.
Limite de Tempo do Script	TimeoutSeconds	Número inteiro	N.º (A predefinição é 300 segundos.)	Especifica o número máximo de segundos para permitir a execução do script.

Erros e exceções	Observações	Exemplo
A atividade script de Windows PowerShell utiliza o serviço de controlo personalizado fornecido por Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida.	Para obter mais informações sobre Windows PowerShell, consulte Windows PowerShell.	Nenhuma

Atividade de Script do VBScript

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

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
A atividade script VBScript depende dos seguintes pré-requisitos no momento da conceção: Nenhum.	Nenhuma

Propriedades

A atividade Script VBScript utiliza as propriedades de entrada descritas na tabela seguinte.

Nome a Apresentar	Nome Interno	Tipo	Necessário	Descrição
Continuar com o Erro	ContinueOnError	Booleano	N.º (A predefinição é Verdadeiro.)	Determina se o fluxo de trabalho continua a ser executado se a atividade falhar.
Tem Erro	HasError		N/D	Especifica se a atividade tem um conjunto de erros. (Só de leitura)
Grupo de Gestão	ManagementGroupName	String	No	Especifica o grupo de gestão ao qual o servidor de scripts pertence. (Por predefinição, está definido como localhost) (Só de leitura)
Parâmetros de Script	Parâmetros	Cadeia de dicionário,cadeia <>	Yes	Fornece a lista dos comutadores padrão e quaisquer valores associados que este script utiliza quando é executado.
Corpo do Script	ScriptBody	String	Yes	Especifica o texto do próprio script.
Servidor de Scripts	Destino	String	No	Especifica o nome DNS (Domain Name System) do servidor que executa a consola Service Manager. Não utilize localhost.
Limite de Tempo do Script	TimeoutSeconds	Número inteiro	N.º (A predefinição é de 300 segundos.)	Especifica o número máximo de segundos para permitir a execução do script.

Erros e exceções	Observações	Exemplo
A atividade script VBScript utiliza o serviço de controlo personalizado fornecido por Service Manager para registar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções conforme adequado se nenhuma das propriedades do script não puder ser resolvida.	Nenhuma	Nenhuma

Atividades do Service Manager

Utilize Service Manager atividades no Service Manager para fazer Service Manager funções parte do fluxo de trabalho.

A Ferramenta de Criação de Service Manager fornece as quatro atividades de Service Manager predefinidas no grupo Atividades de SM no painel Caixa de Ferramentas Atividades.

Criar Atividade de incidentes

Esta atividade cria e preenche um incidente no Service Manager.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	Nenhuma

Propriedades

A atividade Criar Incidente utiliza as propriedades de entrada listadas na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Comentários
ID do Incidente	IncidentID	String	Yes	Especifica o identificador exclusivo que é gerado para o objeto Incidente .
Comentário do Registo de Ações	ActionLogComment	String	Yes	Especifica o comentário a incluir no registo de ações do objeto Incidente .
Domínio de Utilizador Afetado	AffectedUserDomain	String	Yes	Especifica o nome do domínio DNS (Domain Name System) do utilizador primário que é afetado pelo incidente.
Nome de Utilizador Afetado	AffectedUserName	String	Yes	Especifica o nome de utilizador do utilizador principal que é afetado pelo incidente.
Categoria	Categoria	Número inteiro	Yes	Especifica o tipo de incidente, como Rede ou Impressão. O valor é o ID de enum. (Campo de dados de categoria -enum )
Continuar com o Erro	ContinueOnError	Booleano	N.º (A predefinição é verdadeira.)	Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar.
Impacto	Impacto	Número inteiro	Yes	Especifica o impacto do incidente no utilizador ou utilizadores afetados. O valor é o ID de enum. (Impact -enum data type)
Origem	Origem	Número inteiro	No	Especifica a origem de informações sobre o incidente, como Telefone ou E-mail. O valor é o ID de enum. (Campo de tipo de dados de origem -enum )
Resumo	Resumo	String	Yes	Especifica o texto de resumo que descreve o incidente.
Urgência	Urgência	Número inteiro	Yes	Especifica a urgência de resolver o incidente. O valor é o ID de enum. (Campo de tipo de dados Urgência -enum )

A atividade Criar Incidente gera o resultado descrito na tabela seguinte.

Nome	Tipo	Comentários
Incidente de SM	System.WorkItem.Incident	Devolve a instância da classe de incidentes construída.

Erros e exceções	Observações	Exemplo
Nenhuma	Nenhuma	Nenhuma

Obter Atividade de incidentes

Esta atividade obtém um ou mais incidentes no Service Manager.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	Nenhuma

Propriedades

A atividade Obter Incidente utiliza as propriedades de entrada listadas na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Comentários
Domínio de Utilizador Afetado	AffectedUserDomain	String	No	Especifica o nome do domínio DNS (Domain Name System) do utilizador primário que é afetado pelo incidente.
Nome de Utilizador Afetado	AffectedUserName	String	No	Especifica o nome de utilizador do utilizador principal que é afetado pelo incidente.
Categoria	Categoria	Número inteiro	No	Especifica o tipo de incidente, como Rede ou Impressão. O valor é o ID de enum. (Campo de dados de categoria -enum )
Continuar com o Erro	ContinueOnError	Booleano	N.º (A predefinição é verdadeira.)	Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar.
ID do Incidente	IncidentID	String	No	Especifica o identificador exclusivo que é gerado para o objeto de incidente.
Tipo de Pesquisa	SearchType	Número inteiro?	No	Especifica o título do tipo de pesquisa que é utilizado com a atividade.
Estado	Estado	Número inteiro	No	Especifica o estado do incidente. O valor é o ID de enum. (Estado - campo de dados de numeração )
Texto de Resumo	ResumoTexto	String	No	Especifica o texto de resumo que descreve o incidente.

A atividade Obter Incidente gera o resultado descrito na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Comentários
Incidentes de SM	SMIncidents	Matriz de System.Workitem.Incident	Especifica uma matriz de objetos de incidentes.

Erros e exceções	Observações	Exemplo
Nenhuma	A atividade Obter Incidente tem o seu próprio validador para efetuar a validação de erros nas propriedades de entrada.	Nenhuma

Atualizar atividade de Incidentes

Esta atividade no Service Manager guarda as alterações de propriedade num incidente de Service Manager.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	Nenhuma

Propriedades

A atividade Atualizar Incidente utiliza as propriedades de entrada descritas na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
Comentário do Registo de Ações	ActionLogComment	String	No	Especifica um comentário a incluir no registo de ações do objeto Incidente.
Domínio de Utilizador Afetado	AffectedUserDomain	String	No	Especifica o nome do domínio DNS (Domain Name System) do utilizador primário que é afetado pelo incidente.
Nome de Utilizador Afetado	AffectedUserName	String	No	Especifica o nome de utilizador do utilizador principal que é afetado pelo incidente.
Categoria	Categoria	Número inteiro	No	Especifica o tipo de incidente, como Rede ou Impressão. O valor é o ID de enum. (Tipo de dados de categoria -enum )
Continuar com o Erro	ContinueOnError	Booleano	N.º (A predefinição é verdadeira.)	Determina se o fluxo de trabalho deve continuar em execução se a atividade falhar.
Impacto	Impacto	Número inteiro	No	Especifica o impacto do incidente no utilizador ou utilizadores afetados. O valor é o ID de enum. (Impact -enum data type)
Origem	Origem	Número inteiro	No	Especifica a origem de informações sobre o incidente, como Telefone ou E-mail. O valor é o ID de enum. (Tipo de dados de origem -enum )
Incidente de Service Manager	SMIncident	System.Workitem.Incident	No	A instância da classe de incidentes construída a ser atualizada.
Estado	Estado	Número inteiro	No	Especifica o estado do incidente que gerou a atividade. O valor é o ID de enum. (Tipo de dados de estado -enum )
Resumo	Resumo	String	No	Especifica o texto de resumo que descreve o incidente.
Urgência	Urgência	Número inteiro	No	Especifica a urgência de resolver o incidente. O valor é o ID de enum. (Campo de tipo de dados Urgência -enum )

A atividade Atualizar Incidente gera o resultado descrito na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Description
Incidente de SM	SMIncident	System.WorkItem.Incident	Devolve uma atualização da instância da classe de incidentes. O Incidente de SM de entrada e o Incidente de SM de saída são iguais, a menos que a atividade não tenha encontrado o Incidente de SM. Nesse caso, o incidente de SM de saída está definido como Nulo.

Erros e exceções	Observações	Exemplo
Nenhuma	Nenhuma	Nenhuma

Definir o Estado da Atividade como Atividade concluída

Esta atividade atualiza o estado de uma atividade automatizada no Service Manager.

Pré-requisitos de tempo de conceção	Pré-requisitos de tempo de execução
Nenhuma	Nenhum.

Propriedades

A atividade Definir Estado da Atividade como Concluída utiliza as propriedades de entrada descritas na tabela seguinte.

Nome a apresentar	Nome interno	Tipo	Necessário	Descrição
ID da Atividade	ActivityID	String	Yes	Especifica o identificador de um objeto de atividade automatizada Service Manager.

Erros e exceções	Observações	Exemplo
Nenhuma	Quando estiver a utilizar esta atividade num fluxo de trabalho que é acionado por uma atividade automatizada Service Manager, introduza $Data/BaseManagedEntityId$ como o valor desta propriedade. Este valor aplica-se à atividade Definir Estado da Atividade para Concluída na atividade automatizada que acionou a execução do fluxo de trabalho.	Nenhuma