Sobre aplicações personalizadas de clientes de ação personalizada do gestor de configuração

A aplicação de sequência de tarefa, no Gestor de Configuração, executa a operação de ação personalizada durante a implementação do cliente. A aplicação pode ser um processo, um script ou outros comandos. Os requisitos para a aplicação, tais como o ambiente de funcionamento, os argumentos de linha de comando, as propriedades e os códigos de devolução são definidos num ficheiro de Formato de Objeto Gerido (MOF). São adicionados ao ambiente da sequência de tarefas quando a ação é processada.

Arquivo MOF de ação personalizada

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

[   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, ambiente, propriedades e informações de pacotes de implementação personalizadas.

Para obter mais informações, consulte sobre o Ficheiro MOF de Ação Personalizada do Gestor de Configuração.

Entrada de aplicação

As ações personalizadas têm de ser executadas sem vigilância e, por isso, a aplicação não deve solicitar a entrada do utilizador. Todas as entradas devem ser recebidas da linha de comando, do ambiente da sequência de tarefas ou de um ficheiro de dados.

A linha de comando para a aplicação de ação é definida, no ficheiro MOF, utilizando a linha de comando de execução incorporada.

Por exemplo:

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

Processamento de aplicações

A aplicação da sequência de tarefas executa as operações de ação personalizadas. Deve estar ciente do seu ambiente de funcionamento, poder aceder às variáveis ambientais de sequenciação de tarefas, reportar os progressos e devolver códigos de conclusão.

Ambiente

O ficheiro MOF deve especificar o ambiente de funcionamento com a propriedade classe WMI do SMS_TaskSequence_Action Servidor. SupportedEnvironment Os ambientes disponíveis são Windows PE WinPE (, 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é-operativa será provavelmente feita no ambiente pe Windows. Para obter mais informações, consulte os requisitos de Infraestrutura para a implantação do SO. As atualizações dos sistemas operativos atualmente instalados utilizarão todo o ambiente do sistema operativo. Por exemplo, instalação de software ou condutor. Tarefas agnósticas do ambiente do sistema operativo, tais como reinicializações ou criação de ligações de rede, podem ser realizadas utilizando ambas as configurações ambientais.

Em processamento

Durante o processamento, acede às variáveis de sequência de tarefa definidas pelo ficheiro MOF utilizando o TSEnvironment objeto de automatização COM. Para obter mais informações, consulte como utilizar variáveis de sequência de tarefas numa sequência de tarefas do gestor de configuração em execução.

Se a operação demorar muito tempo, pode reportar o progresso para o ambiente da sequência de tarefas e apresentar um indicador de progresso utilizando a Classe de Automação Com Com cliente ProgressUI. Para obter mais informações, consulte Sobre o Relatório de Configuração De Formação Custom Action Progress.

Conclusão

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

Retorno	Descrição
0	Com êxito
Não-zero	Falha

Se for necessário reiniciar após o fim da aplicação, a variável ambiente SMSTSRebootRequested deve ser definida. Para obter mais informações, consulte variáveis de sequência de tarefas. Para obter informações sobre a definição de variáveis ambientais, consulte como utilizar variáveis de sequência de tarefas numa sequência de tarefas do gestor de configuração em execução.

Implementação

Para ser utilizado pelo Gestor de Configuração, a aplicação de ação personalizada deve estar disponível a partir de um pacote do Gestor de Configuração. O administrador pode criar o pacote utilizando a consola 'Gestor de Configuração' ou utilizando uma linguagem de programação. Para mais informações, consulte Como Criar um Pacote.

O identificador de embalagem deve estar disponível para a colocação a funcionar. Normalmente, o ficheiro MOF declara uma propriedade para a deter, como no exemplo seguinte:

[TaskSequencePackage, CommandLineArg(1)]  
string          PackageIDForAbcExe;  

Nota

O identificador de pacotes é a propriedade classe WMI do SMS_Package Servidor. PackageID

O identificador de pacotes é obtido a partir do administrador, quando a ação personalizada é editada no Editor de Sequência de Tarefas.

Para o ativar, o seu controlo de ação personalizado pode utilizar um controlo de edição de texto na sua implementação para obter o identificador de pacotes do administrador. Para um exemplo que utiliza um controlo de texto, consulte Como Criar um Controlador de Ação Personalizado do Gestor de Configuração.

Quando utilizado pelo administrador, o controlo de ação personalizado é editado como parte de uma sequência de tarefas utilizando o Editor de Sequência de Tarefas. Quando guardado pelo Editor de Sequência de Tarefas, é criada uma Classe WMI do SMS_TaskSequencePackage servidor para manter 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 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, a partir do qual os ficheiros binários para a ação personalizada são extraídos e executados.

• O identificador de embalagem é fornecido utilizando o /run parâmetro da linha de comando para Smsswd.exe.

Configuração pré-divisão e pré-partição

Se precisar de configurar a conectividade do disco ou da rede antes de ter uma partição de disco e antes de ter conectividade de rede, terá de criar uma aplicação para executar estas tarefas. A sua aplicação deve ser colocada numa imagem de arranque personalizada utilizando o Kit de Avaliação e Implantação Windows. Para obter mais informações, consulte Windows ADK para Windows 10 cenários para IT Pros.

Nota

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

Em seguida, terá de importar a imagem para o Gestor de Configuração como uma imagem personalizada. Para obter mais informações, consulte Adicionar uma imagem de arranque.

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

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

Consulte também

Sobre as ações personalizadas do gestor de configuração
Sobre o Ficheiro MOF de Ação Personalizada do Gestor de Configuração