Sobre Configuration Manager aplicativos cliente de ação personalizada

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 personalizado

O arquivo MOF para 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 pacote de entrada, ambiente, propriedades e pacote de implantação personalizados do aplicativo de ação.

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

Entrada do aplicativo

As ações personalizadas precisam ser executadas sem vigilância, 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 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 personalizadas. Ele deve estar ciente de seu ambiente operacional e ter acesso às variáveis de ambiente de sequenciamento de tarefas, progresso do relatório e retornar códigos de conclusão.

Ambiente

O arquivo MOF deve especificar o ambiente operacional com a propriedade classe SupportedEnvironmentWMI do servidor SMS_TaskSequence_Action. 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 do Windows PE. Para obter mais informações, consulte Requisitos de infraestrutura para implantação do sistema operacional. Atualizações aos sistemas operacionais atualmente instalados 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 a 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 Como usar variáveis de sequência de tarefas em uma sequência de tarefas em execução Configuration Manager.

Se a operação demorar 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 Sobre relatórios Configuration Manager progresso da ação personalizada.

Conclusão

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

retornar	Descrição
0	Êxito
Não zero	Falha

Se uma reinicialização for necessária após a conclusão do aplicativo, a SMSTSRebootRequested variável de 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 em execução Configuration Manager.

Implantação

Para ser usado por Configuration Manager, o aplicativo de ação personalizado deve estar disponível em um pacote de Configuration Manager. O administrador pode criar o pacote usando o console 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ê-la, como no exemplo a seguir:

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

Observação

O identificador de pacote é a propriedade classe PackageIDWMI do servidor SMS_Package.

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

Para habilitar esse comportamento, o 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 Configuration Manager controle de ação personalizado.

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 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 junto com o pacote de ação personalizado 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 de pacote para a 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 de pacote é fornecido usando o /run parâmetro de linha de comando para Smsswd.exe.

Configuração de partição e pré-partição de pré-rede

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

Observação

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

Em seguida, importe a imagem para 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 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 Configuration Manager arquivo MOF de ação personalizada