Sobre aplicativos cliente de ação personalizada do Configuration Manager

A sequência de tarefas no Configuration Manager faz operações de ação personalizadas durante a implantação do cliente. O aplicativo pode ser um processo, um script ou outros comandos. Os requisitos para o aplicativo são definidos em um arquivo MOF (Formato de Objeto Gerenciado). Os requisitos de exemplo incluem o ambiente operacional, argumentos de linha de comando, propriedades e códigos de retorno. Eles são adicionados ao ambiente de sequência de tarefas quando a ação é processada.

Arquivo MOF de ação personalizada

O arquivo MOF de uma ação personalizada é semelhante ao exemplo a seguir:

[   CommandLine("smsswd.exe /run:%1 abc.exe %2"),
    : (custom ui control and category qualifiers for action)
    ]
class MyCustomAction : SMS_TaskSequence_Action
{
    [TaskSequencePackage, CommandLineArg(1)]
    string          PackageIDForAbcExe;

    [CommandLineArg(2), AllowedLen("1-32000")]
    string          AbcCommandLineArgs;

    [SuccessCodes, Not_Null]
    string          AbcSuccessCodes = "0 3010";

    string         SomeOtherPropertyThatAbcNeeds;

    string          SupportedEnvironment = "WinPEandFullOS";
};

O arquivo MOF descreve as informações necessárias para as informações de entrada, ambiente, propriedades e pacote de implantação do aplicativo de ação personalizado.

Para obter mais informações, consulte Sobre o arquivo MOF deação personalizada do Configuration Manager.

Entrada de aplicativo

As ações personalizadas devem ser realizadas sem supervisão, portanto, o aplicativo não deve solicitar a entrada do usuário. Todas as entradas devem ser recebidas da linha de comando, do ambiente de sequência de tarefas ou de um arquivo de dados.

A linha de comando do aplicativo de ação é definida, no arquivo MOF, usando a ação de linha de comando Executar integrada.

Por exemplo:

CommandLine("smsswd.exe /run:PackageID abc.exe [any abc.exe command line args]"

Processamento de aplicativos

O aplicativo de sequência de tarefas executa as operações de ação personalizadas. Ele deve estar ciente de seu ambiente operacional e ter acesso às variáveis do ambiente de sequenciamento de tarefas, ao progresso do relatório e aos códigos de conclusão de retorno.

Ambiente

O arquivo MOF deve especificar o ambiente operacional com a propriedade SMS_TaskSequence_Action Server WMI Class. SupportedEnvironment Os ambientes disponíveis são Windows PE ( ), sistema operacional WinPE completo ( ), ou ambos os FullOS ambientes ( WinPEandFullOS ).

A escolha do ambiente depende das circunstâncias. Por exemplo, a configuração de instalação pré-operacional provavelmente será feita no ambiente Windows PE. Para obter mais informações, consulte Requisitos de infraestrutura para implantação do sistema operacional. As atualizações para sistemas operacionais instalados no momento usarão o ambiente completo do sistema operacional. Por exemplo, instalação de software ou driver. Tarefas agnósticas do ambiente do sistema operacional, como reinicializações ou criação de conexões de rede, podem ser executadas usando as duas configurações de ambiente.

Processamento

Durante o processamento, você acessa as variáveis de sequência de tarefas definidas pelo arquivo MOF usando o TSEnvironment objeto de automação COM. Para obter mais informações, consulte How to Use Task Sequence Variables in a Running Configuration Manager Task Sequence.

Se a operação levar muito tempo, você poderá relatar o progresso para o ambiente de sequência de tarefas e exibir um indicador de progresso usando a classe de automação COM do cliente ProgressUI. Para obter mais informações, consulte About reporting Configuration Manager custom action progress.

Conclusão

O aplicativo deve definir SuccessCodes a variável de ambiente como um valor de retorno quando for concluída.

retornar Descrição
0 Sucesso
Não zero Falha

Se uma reinicialização for necessária depois que o aplicativo for finalizado, a SMSTSRebootRequested variável de ambiente deverá ser definida. Para obter mais informações, consulte Task sequence variables. Para obter informações sobre como definir variáveis de ambiente, consulte How to use task sequence variables in a running Configuration Manager task sequence.

Implantação

Para ser usado pelo Configuration Manager, o aplicativo de ação personalizado deve estar disponível em um pacote do Configuration Manager. O administrador pode criar o pacote usando o console do Configuration Manager ou usando uma linguagem de programação. Para obter mais informações, consulte Como criar um pacote.

O identificador do pacote deve estar disponível para que a implantação funcione. Normalmente, o arquivo MOF declara uma propriedade para mantê-la, como no exemplo a seguir:

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

Observação

O identificador de pacote é a propriedade SMS_Package Server WMI Class. PackageID

O identificador do pacote é obtido do administrador, quando a ação personalizada é editada no editor da sequência de tarefas.

Para habilitar esse comportamento, seu controle de ação personalizado pode usar um controle de edição de texto em sua implementação para obter o identificador do pacote do administrador. Para um exemplo que usa um controle de texto, consulte How to create a Configuration Manager custom action control.

Quando usado pelo administrador, o controle de ação personalizado é editado como parte de uma sequência de tarefas usando o editor de sequência de tarefas. Quando salvo pelo editor de sequência de tarefas, uma classe WMI do servidor SMS_TaskSequencePackage é criada para manter a sequência de tarefas, incluindo a ação personalizada.

Em seguida, o pacote de sequência de tarefas é anunciado aos clientes juntamente com o pacote de ações personalizado referenciado pela ação personalizada. Para obter mais informações, consulte Como criar um anúncio.

Quando a ação personalizada é executado no cliente, o identificador de pacote da ação personalizada é fornecido como um parâmetro de linha de comando, do qual os arquivos binários da ação personalizada são extraídos e executados.

O identificador do pacote é fornecido usando o parâmetro /run de linha de comando para Smsswd.exe.

Partição pré-rede e configuração de pré-partição

Se você precisar configurar a conectividade de disco ou rede antes de ter uma partição de disco e antes de ter conectividade de rede, você precisará criar um aplicativo para fazer essas tarefas. Seu aplicativo deve ser colocado em uma imagem de inicialização personalizada usando Windows Kit de Avaliação e Implantação (ADK). Para obter mais informações, consulte Windows cenários do ADK para profissionais de IT.

Observação

A adição de arquivos ao arquivo de imagem de inicialização pode aumentar os requisitos mínimos de RAM e pode, devido às condições de memória baixa, fazer com que as sequências de tarefas falhem de maneiras inesperadas.

Em seguida, importe a imagem para o Configuration Manager como uma imagem personalizada. Para obter mais informações, consulte Adicionar uma imagem de inicialização.

O aplicativo, todos os arquivos de suporte e o SMSTS.INI personalizados devem ser colocados na pasta Windows.

Para usar o aplicativo, use a imagem de inicialização personalizada em uma sequência de tarefas que contém uma etapa de pré-partição/rede.

Confira também

Sobre as ações personalizadas do Gerenciador de Configurações

Sobre o arquivo MOF de ação personalizada do Configuration Manager