Configurações de distribuição
Use a página Distribuição > Definições para configurar mapeamentos dos códigos de retorno dos aplicativos. As ações executáveis e de pacote de scripts podem retornar um código numérico positivo ou negativo na saída, indicando vários resultados. Esses códigos de retorno afetam o estado do aplicativo e determinam se uma ação é bem-sucedida, malsucedida ou requer reinicialização.
Use mapeamentos de código de retorno customizados para personalizar o resultado de ações EXE, MSI e script. Por exemplo, o utilitário Robocopy da Microsoft possui vários códigos de retorno que indicam sucesso. Por padrão, um código de retorno de executável diferente de zero indica falha. Você pode criar um mapeamento de código de retorno personalizado para o Robocopy que associe esses códigos de retorno diferentes de zero a sucesso, permitindo que o processamento do pacote continue.
Os códigos de retorno são armazenados em um log no dispositivo como parte de cada distribuição. Para mais informações sobre logs e como acessá-los, consulte Regra de detecção e log de ações.
Além de ter códigos de retorno numéricos armazenados no log, você pode relacionar esses códigos de retorno a strings informativas. As strings que descrevem os códigos de retorno também aparecerão no log.
Existem três tipos de modelo de código de retorno:
- Novos modelos que você cria.
- Cópias clonadas de um modelo existente. Para clonar um modelo existente, use o menu de opções (
) à direita do modelo.
- Modelos padrão que você não pode editar ou excluir, a não ser marcá-los como modelo padrão. Você pode editar uma cópia clonada.
Estes são os modelos padrão de código de retorno. Falha é o comportamento padrão para os códigos de retorno não mapeados neles.
- Modelo do Sistema - MSI Padrão: contém o conjunto padronizado de códigos de retorno MSI. Eles são pré-configurados para você.
- Modelo do Sistema - EXE Padrão: contém um mapeamento de código de retorno para o número zero, indicando sucesso.
- Modelo do Sistema - PowerShell Padrão: contém dois mapeamentos de código de retorno. O número zero indica sucesso, e o número um indica falha.
Um de cada tipo de modelo (MSI, EXE e PowerShell) pode ser marcado como padrão. A lista Mapeamentos de códigos de retorno possui uma coluna que mostra quais modelos são padrão. Para alterar um padrão, edite o modelo e selecione essa opção.
Ao criar uma ação de pacote que suporte um modelo de código de retorno, o padrão será pré-selecionado para você. Se não quiser usar o padrão, poderá selecionar outros modelos para esse tipo de ação. As alterações feitas no modelo entrarão em vigor na próxima vez que o mecanismo de distribuição for executado no cliente.
Os modelos de código de retorno MSI incluem um mapeamento de código de retorno para 3010, Sucesso - Necessário Reinicializar. Este resultado equivale a Sucesso, mas com uma observação no log do dispositivo, para aquela distribuição, de que ele precisará ser reinicializado em algum momento. O status de implantação desse pacote também mostrará "Sucesso (necessário reinicializar)".
Para criar ou editar um modelo de código de retorno
- Selecione Criar novo e o tipo de modelo desejado ou selecione um modelo existente. Os modelos de sistema pré-configurados são somente leitura.
- Insira o Nome do modelo e uma Descrição.
- Em Tornar este o modelo padrão, selecione Verdadeiro se desejar que o modelo seja o padrão para o tipo de modelo selecionado (como EXE ou PowerShell).
- Selecione Resultado padrão para os códigos de retorno não mapeados. O padrão é Falha. O resultado selecionado é o que ocorrerá para os códigos retornados da ação que não estejam na lista de códigos de retorno. Por exemplo, se você escolher Falha (recomendado), todos os códigos de retorno que não estiverem na lista farão com que a ação seja retornada como falha. Se você escolher Sucesso, todos os outros códigos de retorno serão retornados como bem-sucedidos.
- Especifique o texto da Mensagem padrão que aparece para o resultado padrão selecionado nos códigos de retorno não mapeados.
- Selecione + Adicionar código de retorno.
- Insira o número ou intervalo numérico em formato inteiro (sem decimais) do Código de retorno, o Resultado (Falha ou Sucesso) e o texto da Mensagem que você deseja registrar junto com o código de retorno. Para inserir um intervalo numérico, separe os números com dois pontos, tal como 15..30.
- Selecione Salvar.
- Repita as etapas 7 e 8 para cada código de retorno desejado.
- Quando terminar, feche o painel Adicionar novo mapeamento e selecione Salvar.
