Acerca Configuration Manager aplicações cliente de ação personalizada

A sequência de tarefas no Configuration Manager faz operações de ação personalizadas durante a implementação do cliente. A aplicação pode ser um processo, um script ou outros comandos. Os requisitos para a aplicação são definidos num ficheiro MOF (Managed Object Format). Os requisitos de exemplo incluem o ambiente operativo, os argumentos da linha de comandos, as propriedades e os códigos de retorno. São adicionados ao ambiente de sequência de tarefas quando a ação é processada.

Ficheiro MOF de ação personalizada

O ficheiro 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 ficheiro MOF descreve as informações necessárias para a entrada da aplicação de ação personalizada, o ambiente, as propriedades e as informações do pacote de implementação.

Para obter mais informações, veja Acerca do ficheiro MOF da ação personalizada Configuration Manager.

Entrada da aplicação

As ações personalizadas têm de ser executadas sem supervisão, pelo que a aplicação não deve pedir a entrada do utilizador. Todas as entradas devem ser recebidas da linha de comandos, do ambiente de sequência de tarefas ou de um ficheiro de dados.

A linha de comandos da aplicação de ação está definida, no ficheiro MOF, com a ação incorporada Executar linha de comandos .

Por exemplo:

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

Processamento de aplicações

A aplicação de sequência de tarefas executa as operações de ação personalizada. Tem de estar ciente do respetivo ambiente operacional e ter acesso às variáveis de ambiente de sequenciação de tarefas, ao progresso do relatório e aos códigos de conclusão de devolução.

Ambiente

O ficheiro MOF deve especificar o ambiente operativo com a propriedade Classe SupportedEnvironmentWMI de Servidor SMS_TaskSequence_Action. Os ambientes disponíveis são o Windows PE (WinPE), o sistema operativo 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 será provavelmente efetuada no ambiente do Windows PE. Para obter mais informações, veja Requisitos de infraestrutura para a implementação do SO. Atualizações a sistemas operativos atualmente instalados utilizarão o ambiente de sistema operativo completo. Por exemplo, instalação de software ou controlador. As tarefas agnósticas do ambiente do sistema operativo, como reinícios ou a criação de ligações de rede, podem ser executadas com ambas as definições de ambiente.

Processamento

Durante o processamento, pode aceder às variáveis de sequência de tarefas definidas pelo ficheiro MOF com o TSEnvironment objeto de automatização COM. Para obter mais informações, veja How to Use Task Sequence Variables in a Running Configuration Manager Task Sequence (Como Utilizar Variáveis de Sequência de Tarefas numa Sequência de Tarefas em Execução Configuration Manager).

Se a operação demorar muito tempo, pode comunicar o progresso ao ambiente de sequência de tarefas e apresentar um indicador de progresso com a classe de automatização COM do cliente ProgressUI. Para obter mais informações, veja Acerca dos relatórios Configuration Manager progresso da ação personalizada.

Conclusão

A aplicação deve definir a variável de SuccessCodes ambiente como um valor devolvido quando estiver concluída.

retornar	Descrição
0	Êxito
Diferente de zero	Falha

Se for necessário reiniciar após a conclusão da aplicação, a variável de SMSTSRebootRequested ambiente deve ser definida. Para obter mais informações, veja Variáveis de sequência de tarefas. Para obter informações sobre como definir variáveis de ambiente, veja Como utilizar variáveis de sequência de tarefas numa sequência de tarefas Configuration Manager em execução.

Implantação

Para ser utilizada por Configuration Manager, a aplicação de ação personalizada tem de estar disponível a partir de um pacote de Configuration Manager. O administrador pode criar o pacote com a consola do Configuration Manager ou com uma linguagem de programação. Para obter mais informações, veja Como criar um pacote.

O identificador do pacote tem de estar disponível para que a implementação funcione. Normalmente, o ficheiro MOF declara uma propriedade para a conter, tal como no exemplo seguinte:

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

Observação

O identificador do pacote é a propriedade Classe PackageIDWMI de Servidor SMS_Package.

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

Para ativar este comportamento, o controlo de ação personalizada pode utilizar um controlo de edição de texto na respetiva implementação para obter o identificador do pacote junto do administrador. Para obter um exemplo que utiliza um controlo de texto, veja Como criar um Configuration Manager controlo de ação personalizado.

Quando utilizado pelo administrador, o controlo de ação personalizada é editado como parte de uma sequência de tarefas com o editor de sequência de tarefas. Quando guardado pelo editor de sequência de tarefas, é criada uma Classe WMI de Servidor SMS_TaskSequencePackage 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ção personalizado que é referenciado pela ação personalizada. Para obter mais informações, veja 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 comandos, a partir do qual os ficheiros binários da ação personalizada são extraídos e executados.

O identificador do pacote é fornecido com o parâmetro da /run linha de comandos para Smsswd.exe.

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

Se precisar de configurar a conectividade de disco ou de rede antes de ter uma partição de disco e antes de ter conectividade de rede, terá de criar uma aplicação para realizar estas tarefas. A sua aplicação deve ser colocada numa imagem de arranque personalizada com o Windows Assessment and Deployment Kit (ADK). Para obter mais informações, veja Cenários do Windows ADK para Profissionais de TI.

Observação

Adicionar ficheiros ao ficheiro de imagem de arranque pode aumentar os requisitos mínimos de RAM e pode, devido a condições de memória baixa, fazer com que as sequências de tarefas falhem de formas inesperadas.

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

A aplicação, quaisquer ficheiros de suporte e os SMSTS.INI personalizados devem ser colocados na pasta do Windows.

Para utilizar a aplicação, utilize a imagem de arranque personalizada numa sequência de tarefas que contenha um passo de pré-partição/rede.

Confira também

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

Acerca do ficheiro MOF da ação personalizada Configuration Manager