Atividades de administrador do ExchangeExchange Administrator Activities

Importante

Esta versão do Orchestrator atingiu o fim do suporte, recomendamos que você atualize para o orchestrator 2019.This version of Orchestrator has reached the end of support, we recommend you to upgrade to Orchestrator 2019.

As instruções de configuração a seguir se aplicam a todas as atividades executadas no pacote de integração de administração do Exchange.The following configuration instructions apply to all activities that are performed in the Exchange Admin Integration Pack. Os tópicos de configuração detalhada para atividades específicas de administração do Exchange contêm links de volta para essas instruções gerais.The detailed configuration topics for specific Exchange Admin activities all contain links back to these general instructions.

Cada procedimento neste tópico é executado em uma atividade que foi colocada na janela de runbook da runbook designer do Orchestrator.Each procedure in this topic is performed on an activity that has been placed in the runbook window of the Orchestrator Runbook Designer.

Propriedades da atividadeActivity properties

Cada atividade é configurada com um conjunto de propriedades obrigatórias ou opcionais.Each activity is configured with a set of required or optional properties. Elas definem como a atividade se conecta a outras atividades ou como a atividade executa suas ações.These define how the activity connects to other activities or how the activity performs its actions. Quando uma atividade é colocada na janela do runbook, você pode exibir ou modificar suas propriedades.When an activity has been placed in the runbook window, you can view or modify its properties.

Observação

A propriedade precisa ter um valor, caso contrário, a propriedade não será passada para a atividade.The property needs to have a value, otherwise the property will not be passed to the activity. Uma cadeia de caracteres vazia ou espaços não são considerados um valor válido.An empty string or spaces are not considered valid value. por exemplo, a atividade getmailbox tem uma identidade de propriedade.e.g. GetMailbox activity has a property Identity. Se o valor dessa identidade de propriedade for passado "" ou "", a propriedade de identidade será omitida.If the value for this property Identity is passed "" or " ", then the Identity property will be omitted.

Para exibir e configurar as propriedades de uma atividadeTo view and configure the properties for an activity

  1. Clique duas vezes na atividade.Double-click the activity. Como alternativa, você pode clicar com o botão direito do mouse na atividade e clicar em Propriedades.Alternatively, you can right-click the activity, and then click Properties.
  2. Exiba e configure as propriedades da atividade, conforme necessário.View and configure the activity properties as needed.
  3. Para salvar suas entradas de configuração, clique em concluir.To save your configuration entries, click Finish.

Na caixa de diálogo Propriedades da atividade, várias guias fornecem acesso a configurações gerais e específicas para a atividade.In the activity properties dialog box, various tabs provide access to general and specific settings for the activity. O número de guias disponíveis para propriedades de objeto variará de acordo com a atividade.The number of available tabs for object properties will vary according to the activity.

Guia GeralGeneral tab

A guia geral contém as propriedades nome e Descrição da atividade.The General tab contains the Name and Description properties for the activity. Por padrão, o nome da atividade é o mesmo que seu tipo de atividade e a Descrição fica em branco.By default, the Name of the activity is the same as its activity type and the Description is blank. Você pode modificar essas propriedades para fornecer um nome mais específico ou para adicionar uma descrição, conforme necessário.You can modify these properties to provide a more specific name or to add a description as necessary.

Guia PropriedadesProperties tab

A guia Propriedades contém propriedades que são específicas para a atividade.The Properties tab contains properties that are specific to the activity. Todas as atividades neste pacote de integração têm a propriedade nome da configuração na guia Propriedades . A propriedade nome da configuração é usada para especificar a conexão com o Exchange Server.All activities in this integration pack have the Configuration Name property on the Properties tab. The Configuration Name property is used to specify the connection to the Exchange server.

Para configurar a propriedade nome da configuraçãoTo configure the Configuration Name property

  1. Clique no botão de reticências (...) ao lado do campo nome .Click the ellipsis (...) button next to the Name field.

  2. Selecione o nome de conexão aplicável.Select the applicable connection name. As conexões exibidas na lista foram configuradas anteriormente, conforme descrito no pacote de integração de administração do Exchange para o System Center-Orchestrator.Connections displayed in the list have been previously configured as described in Exchange Admin Integration Pack for System Center - Orchestrator.

Critérios para filtrosCriteria for filters

As atividades Get usam filtros para determinar os valores que irão invocar um runbook ou recuperar atividades.The Get activities use filters to determine the values that will invoke a runbook or retrieve activities. Os valores de propriedade de candidatos potenciais são comparados aos valores dos filtros para determinar se eles atendem aos critérios.Property values of potential candidates are compared to the values of the filters to determine if they meet the criteria. Ao especificar critérios de filtro, você pode selecionar um dos métodos de comparação disponíveis.When you specify filter criteria, you can select one of the available methods of comparison. O sistema fornece uma opção para corresponder ou não corresponder ao filtro usando cada método.The system provides an option to either match or not match the filter using each method. Por exemplo, a versão "não" de um método localiza itens que não correspondem ao filtro.For example, the "Does not" version of a method finds items that do not match the filter. Todos os filtros de texto diferenciam maiúsculas de minúsculas.All text filters are case sensitive.

  • Equals: a propriedade do item corresponde ao texto ou ao número especificado no filtro.Equals: The property of the item matches the text or number specified in the filter.
  • Não é igual: a propriedade do item não corresponde ao texto ou ao número especificado no filtro.Does not equal: The property of the item does not match the text or number specified in the filter.
  • É menor que: a propriedade numérica do item é menor que o número especificado no filtro.Is less than: The numeric property of the item is less than the number specified in the filter.
  • É menor ou igual a: a propriedade numérica do item é menor ou igual ao número especificado no filtro.Is less than or equal to: The numeric property of the item is less than or equal to the number specified in the filter.
  • É maior que: a propriedade numérica do item é maior que o número especificado no filtro.Is greater than: The numeric property of the item is greater than the number specified in the filter.
  • É maior ou igual a: a propriedade numérica do item é maior ou igual ao número especificado no filtro.Is greater than or equal to: The numeric property of the item is greater than or equal to the number specified in the filter.
  • Contains: a propriedade do item contém o texto exato especificado no filtro.Contains: The property of the item contains the exact text specified in the filter. Pode haver outro texto ao redor do texto correspondente.There can be other text surrounding the matching text.
  • Não contém: a propriedade do item não contém o texto exato especificado no filtro.Does not contain: The property of the item does not contain the exact text specified in the filter.
  • Corresponde ao padrão: esse método de comparação usa expressões regulares para especificar um padrão que o texto deve corresponder.Matches pattern: This comparison method uses regular expressions to specify a pattern that the text must match.
  • Não corresponde ao padrão: esse método de comparação usa expressões regulares para especificar um padrão para o qual o texto não deve corresponder.Does not match pattern: This comparison method uses regular expressions to specify a pattern that the text must not match.
  • Começa com: a propriedade do item começa com o texto exato especificado no filtro.Starts with: The property of the item starts with the exact text specified in the filter.
  • Termina com: a propriedade do item termina com o texto exato especificado no filtro.Ends with: The property of the item ends with the exact text specified in the filter.

A guia comportamento de execuçãoThe Run Behavior tab

A guia comportamento de execução contém as propriedades que determinam como a atividade manipula dados publicados com vários valores e quais notificações serão enviadas se a atividade falhar ou for executada por um período de tempo excessivo.The Run Behavior tab contains the properties that determine how the activity handles multi-value published data and which notifications will be sent if the activity fails or runs for an excessive period of time.

Vários valores nos dados publicadosMultiple values in published data

As atividades Get recuperam informações de outra atividade ou de origem externa e, em seguida, podem retornar um ou mais valores nos dados publicados.The Get activities retrieve information from another activity or outside source and can then return one or more values in the published data. Por exemplo, a saída de dados da atividade obter caixa de correio pode ser os detalhes de uma caixa de correio existente.For example, the data output from the Get Mailbox activity could be the details of an existing mailbox.

Por padrão, os dados da atividade Get serão passados como várias saídas individuais.By default, the data from the Get activity will be passed on as multiple individual outputs. Essas várias saídas invocarão a próxima atividade prescrita quantas vezes houver itens na saída.These multiple outputs will invoke the next prescribed activity as many times as there are items in the output. Como alternativa, para solicitar uma única saída combinada para a atividade, você pode habilitar a opção achatar .Alternatively, to request a single combined output for the activity, you can enable the Flatten option. Ao habilitar a opção nivelar , você deve especificar o formato de saída:When you enable the Flatten option, you must specify the output format:

  • Separar com quebras de linha.Separate with line breaks. Cada item está em uma nova linha.Each item is on a new line. Esse formato é útil para criar arquivos de texto legíveis.This format is useful for creating human-readable text files.
  • Separe com.Separate with. Cada item é separado por um ou mais caracteres de sua escolha.Each item is separated by one or more characters of your choice.
  • Use o formato CSV.Use CSV format. Todos os itens estão no formato CSV (valores separados por vírgula).All items are in CSV (comma-separated value) format. Esse formato é útil para importar dados em planilhas ou em outros aplicativos.This format is useful for importing data into spreadsheets or other applications.

A atividade obter produzirá um novo conjunto de dados toda vez que ele for executado.The Get activity will produce a new set of data every time it runs. O recurso nivelar não mescla dados entre várias instâncias da mesma atividade.The Flatten feature does not flatten data across multiple instances of the same activity.

Notificações de eventos de tempo limite e falhaTimeout and failure event notifications

Algumas atividades devem levar apenas uma quantidade limitada de tempo para serem concluídas.Some activities are expected to take only a limited amount of time to complete. Se elas não forem concluídas em um período de tempo esperado, elas poderão estar paralisadas ou pode haver outro problema, impedindo a conclusão.If they do not complete within an expected timeframe, they may be stalled or there may be another issue preventing completion. Você pode definir o número de segundos para aguardar a conclusão da ação.You can define the number of seconds to wait for completion of the action. Se o processamento da atividade exceder esse limite de tempo limite, um evento de plataforma será enviado e o problema será relatado.If the processing of the activity exceeds this timeout threshold, a platform event will be sent and the issue will be reported. Você também pode escolher se deseja gerar um evento de plataforma se a atividade retornar uma falha.You can also choose whether to generate a platform event if the activity returns a failure.

Para ser notificado quando a atividade demorar mais do que um tempo especificado para ser executada ou falhar na execuçãoTo be notified when the activity takes longer than a specified time to run or fails to run

  1. Na caixa notificações de eventos , insira o número de segundos de tempo de execução antes que uma notificação seja gerada.In the Event Notifications box, enter the number of seconds of run time before a notification is generated.

  2. Selecione relatório se a atividade não for executada para gerar notificações de falha de execução.Select Report if activity fails to run to generate run failure notifications.

Dados publicadosPublished data

Os dados publicados são os dados produzidos como resultado das ações de uma atividade.Published data is the data produced as a result of the actions of an activity. Esses dados são publicados em um barramento de dados interno que é exclusivo para cada runbook.This data is published to an internal data bus that is unique for each runbook. Os dados publicados são a base de um runbook de trabalho.Published data is the foundation of a working runbook. As atividades subsequentes no runbook podem assinar esses dados e usá-los em sua configuração.Subsequent activities in the runbook can subscribe to this data and use it in their configuration. As condições de link também usam essas informações para adicionar recursos de tomada de decisão a runbooks.Link conditions also use this information to add decision-making capabilities to runbooks.

Uma atividade pode assinar somente os dados das atividades que estão vinculadas antes dela no runbook.An activity can subscribe only to data from the activities that are linked before it in the runbook. Você pode usar dados publicados para preencher automaticamente os valores de propriedade necessários pelas atividades.You can use published data to automatically populate the property values needed by activities.

Para usar dados publicadosTo use published data

  1. Clique com o botão direito do mouse na caixa valor da propriedade, clique em assinare, em seguida, clique em dados publicados.Right-click the property value box, click Subscribe, and then click Published Data.
  2. Clique na caixa suspensa atividade e selecione a atividade da qual você deseja obter os dados.Click the Activity drop-down box and select the activity from which you want to obtain the data. Para exibir elementos de dados adicionais comuns a todos os runbooks, selecione Mostrar dados publicados comuns.To view additional data elements common to all runbooks, select Show Common Published Data.
  3. Clique no elemento de dados publicados que você deseja usar e, em seguida, clique em OK.Click the published data element that you want to use, and then click OK.

Para obter uma lista dos elementos de dados publicados por cada atividade, consulte a tabela de dados publicados no tópico atividade específica.For a list of the data elements published by each activity, see the Published Data table in the specific activity topic. Para obter informações sobre os itens de dados publicados comuns, consulte dados publicados comuns.For information about the common published data items, see Common Published Data.

AtividadesActivities

Este pacote de integração adiciona a categoria administrador do Exchange ao painel atividade na runbook designer.This integration pack adds the Exchange Admin category to the Activity pane in the Runbook Designer. Essa categoria contém as seguintes atividades:This category contains the following activities:

Criar caixa de correio Criar solicitação de movimentação Criar caixa de correio remota (híbrido) Desabilitar caixa de correio Desabilitar caixa de correio remota (híbrido) Habilitar caixa de correio Habilitar caixa de correio remota (híbrido) Obter caixa de correio Obter solicitação de movimentação Obter estatísticas de solicitação de movimentação Obter caixa de correio remota (híbrido) Remover caixa de correio Remover caixa de correio remota (híbrido) Executar o comando do PowerShell do Exchange Atualizar caixa de correio Atualizar solicitação de movimentação Atualizar caixa de correio remota (híbrido)Create Mailbox Create Move Request Create Remote Mailbox (Hybrid) Disable Mailbox Disable Remote Mailbox (Hybrid) Enable Mailbox Enable Remote Mailbox (Hybrid) Get Mailbox Get Move Request Get Move Request Statistics Get Remote Mailbox (Hybrid) Remove Mailbox Remove Remote Mailbox (Hybrid) Run Exchange PowerShell Command Update Mailbox Update Move Request Update Remote Mailbox (Hybrid)