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 (Managed Object Format). Exemplos de requisitos 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.

Ação personalizada Arquivo MOF

O arquivo MOF para uma ação personalizada é semelhante ao seguinte exemplo:

[   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 a entrada do aplicativo de ação personalizada, o ambiente, as propriedades e as informações do pacote de implantação.

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

Entrada do aplicativo

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

A linha de comando para o aplicativo de ação é definida, no arquivo MOF, usando a ação interna Executar Linha de Comando .

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 personalizada. Ele deve estar ciente de seu ambiente operacional e ter acesso às variáveis de ambiente de sequenciamento de tarefas, relatar o progresso e retornar códigos de conclusão.

Ambiente

O arquivo MOF deve especificar o ambiente operacional com a propriedade Classe SupportedEnvironmentWMI do SMS_TaskSequence_Action Server. Os ambientes disponíveis são Windows PE (WinPE), sistema operacional completo (FullOS) ou ambos os 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. Atualizações para sistemas operacionais instalados atualmente usarão o ambiente completo do sistema operacional. Por exemplo, instalação de software ou driver. Tarefas agnósticas de ambiente de sistema operacional, como reinicializações ou criação de conexões de rede, podem ser executadas usando as configurações de ambos os ambientes.

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 Como usar variáveis de sequência de tarefas em uma sequência de tarefas do Configuration Manager em execução.

Se a operação demorar muito, 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 Sobre como relatar o progresso da ação personalizada do Configuration Manager.

Conclusão

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

Se uma reinicialização for necessária após o término do aplicativo, a variável de SMSTSRebootRequested ambiente deverá ser definida. Para obter mais informações, consulte Variáveis de sequência de tarefas. Para obter informações sobre como definir variáveis de ambiente, consulte Como usar variáveis de sequência de tarefas em uma sequência de tarefas do Configuration Manager em execução.

Implantação

Para ser usado pelo Configuration Manager, o aplicativo de ação personalizada 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 de pacote deve estar disponível para que a implantação funcione. Normalmente, o arquivo MOF declara uma propriedade para mantê-lo, como no exemplo a seguir:

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

O identificador de pacote é obtido do administrador, quando a ação personalizada é editada no editor de 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 de pacote do administrador. Para obter um exemplo que usa um controle de texto, consulte Como criar um controle de ação personalizada do Configuration Manager.

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 salva pelo editor de sequência de tarefas, uma Classe WMI do SMS_TaskSequencePackage Server é criada para conter a sequência de tarefas, incluindo a ação personalizada.

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

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

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

Partição de 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, precisará criar um aplicativo para realizar essas tarefas. Seu aplicativo deve ser colocado em uma imagem de inicialização personalizada usando o Kit de Avaliação e Implantação do Windows (ADK). Para obter mais informações, consulte Cenários do Windows ADK para profissionais de TI.

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 personalizado devem ser colocados na pasta do Windows.

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

Confira também

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

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