Partilhar via

Sobre o Gestor de Configuração Ficheiros MOF de Ação Personalizada

  • Artigo

No Gestor de Configuração, as ações de implementação do sistema operativo são definidas no ficheiro Formato de Objeto Gerido (MOF), %ProgramFiles%\Microsoft Configuration Manager\bin\i386 \ _tasksequenceprovider.mof.

Quando criar uma ação personalizada, deve criar um ficheiro MOF que declare a sua ação personalizada. Em seguida, utilize Mofcomp.exe para adicionar as suas alterações ao Fornecedor DE SMS. Para obter mais informações, consulte Como Criar um Ficheiro MOF para uma Ação Personalizada do Gestor de Configuração.

O administrador configura a ação personalizada, tal como definida pelo ficheiro MOF, utilizando um controlo de ação personalizado. Para obter mais informações, consulte Sobre as ações personalizadas do Gestor de Configuração.

Conteúdo de ficheiro MOF

Uma ação personalizada deriva da classe WMI do SMS_TaskSequence_Action Servidor. A declaração de ficheiro MOF inclui uma definição de classe e vários qualificadores para a linha de comando, variáveis de sequência de tarefas, categoria e localização de montagem de controlo de ação personalizada.

As propriedades declaradas numa classe, exceto as que têm o CommandLineArg qualificador, estão disponíveis como variáveis de sequência de tarefas durante a implementação do cliente. 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.

O espaço de nome para a ação personalizada é \ \root\SMS_Site_SITECODE. Quando o ficheiro MOF é compilado, a ação personalizada é feita uma criança de SMS_TaskSequence_Action Classe WMI do servidor.

Nota

Por exemplo, MOF, consulte a ação de sequência de tarefa MOF que é declarada em _tasksequenceprovider.mof.

A secção do ficheiro MOF para a declaração de ação personalizada será semelhante ao seguinte exemplo:

[   CommandLine("smsswd.exe /run:%1 Application.exe /user:%2"),  
    VariablePrefix("MyCustomActionPrefix"),  
    ActionCategory("My Custom Action Category,7,1"),  
    ActionName{"ConfigMgrTSAction.dll", "ConfigMgrTSAction.Properties.Resources", "ConfigMgrTSAction"},  
    ActionUI{"ConfigMgrTSAction.dll", "ConfigMgrTSAction","ConfigMgrTSActionControl",   
"ConfigureTSActionOptions"}  
    ]  
class ConfigMgrTSActionControl : SMS_TaskSequence_Action  
{  
    [TaskSequencePackage, CommandLineArg(1)]  
    string          PackageIDForApplicationExe;  

    [Not_Null, CommandLineArg(2)]  
    string          User;  

    [VariableName("CustomLocation")]  
    string          Location;  

};

O MOF completo também especifica o espaço de nome e outras informações,

Para obter o MOF completo para esta amostra, consulte como criar um ficheiro MOF para uma ação personalizada do Gestor de Configuração.

Linha de Comandos

A linha de comando para a ação é descrita na qualificação de CommandLine classe. Define a aplicação que é chamada e os vários argumentos que podem ser fornecidos. Para cada argumento de linha de comando, há uma CommandLineArg qualificação de classe para o argumento na propriedade de classe correspondente.

CommandLine normalmente toma o formulário:

CommandLine("smsswd.exe /run:%1 Application.exe %2 %3")

Smsswd.exe é usado para executar um programa dentro de um pacote. Requer os seguintes argumentos:

Argumento Description
/run:%1 Identifica o pacote em que o pedido está. %1 é o identificador de pacotes (SMS_Package propriedadeclasse WMI do servidor). PackageID
Application.exe A aplicação de ação personalizada que é executada.
%2 - %n Um ou mais argumentos de linha de comando para Application.exe.

As cordas de substituição da linha de comando, %1, %2 e assim por diante, são definidas pela classificação de CommandLineArg classe. Por exemplo, o seguinte declara %1.

[TaskSequencePackage, CommandLineArg(1)]  
string          PackageIDForApplicationExe;

Com o controlo de ação personalizado, você usa a PackageIDForApplicationExe propriedade para configurar o identificador de pacote.

Nota

As propriedades declaradas com o CommandLineArg qualificador não estão disponíveis como variáveis de sequência de tarefas durante a implementação do cliente.

Categoria de Ação

Uma ação pode ser associada a uma categoria específica, no menu de entrega do editor da sequência de tarefas, utilizando o qualificador de ActionCategory classe.

Nota

Não utilize uma categoria que já esteja a ser utilizada por outra ação.

A sintaxe é:

ActionCategory{CategoryName,ActionOrder,CategoryOrder}

CategoryName
O nome da categoria.

ActionOrder
A ordem de ação dentro da categoria.

CategoryOrder
A ordem de categoria em todas as categorias.

As categorias de Gestor de Configuração predefinido a que pode adicionar uma ação são:

  • Geral

  • Discos

  • Estado do Utilizador

  • Imagens

  • Controladores

  • Definições

    Também pode criar uma nova categoria especificando uma nova categoria na qualificação de ActionCategory classe. Por exemplo, o seguinte ficheiro MOF cria uma nova categoria chamada My Custom Category. A ação está em segundo lugar na categoria e a categoria está em quinto lugar na geral.

    ActionCategory{"My Custom Category",2,5"},

Nome de Ação

O ActionName qualificador de classe define o nome de controlo de ação personalizado. A qualificação tem a seguinte sintaxe:

ActionName{"Assembly", "Namespace.Properties.Resources", "Control"}

Assembly
O conjunto que contém o controlo de ação.

Namespace.Properties.Resources
O espaço de nome para o recurso que contém as cordas do nome de ação apresentadas. Para obter mais informações, consulte Como Criar um Controlador de Ação Personalizado do Gestor de Configuração.

Control
O controlo que contém os recursos de corda.

Interface de utilizador de ação

O ActionUI qualificador de classe define a localização da montagem e classes que são usadas por uma ação. A qualificação tem a seguinte sintaxe:

ActionUI{"Assembly","Namespace", "Control", "Option control"}

Assembly
O conjunto que contém o controlo de ação.

Namespace
O espaço de nome em que o controlo de ação reside.

Control
O controlo de ação exibido no editor da sequência de tarefas. Acolhe a página de controlo de opções.

Option control
A página usada para gerir opções de ação, no editor de sequência de tarefas.

Vários separadores de controlo podem ser implementados através da inclusão de mais nomes de classes de controlo separados por vírgulas. Por exemplo:

ActionUI{"Assembly","Namespace", "Control1", "Control2", "Control3", "Controlo de opções"}

Variáveis de Ação

O VariableName qualificador é usado para anular o nome variável padrão para uma propriedade.

Uma propriedade de classe pode ser definida como uma variável de sequência de tarefa adicionando a VariableName qualificação de classe. No exemplo acima, a propriedade MessageTimeout é uma variável de ação com o RebootTimeout nome.

Se o qualificador de VariablePrefix classe for utilizado, as variáveis são pré-fixas com o valor de qualificação de classe.

Para obter mais informações sobre a utilização variável, consulte como utilizar variáveis de sequência de tarefas numa sequência de tarefas do gestor de configuração de execução

Propriedades

Eliminatórias

Existem várias qualificações que podem ser aplicadas às propriedades da MOF. São geralmente utilizados os seguintes:

Eliminatória Description
CommandLineArg Um imóvel que deve ser inserido na linha de comando
Not_Null É necessário um valor para esta propriedade.
ValorMap Especifica uma lista de valores de cordas permitidos.
ValueRange Especifica uma gama de valores permitidos (campos int).
Ifnull obrigatório Um valor é necessário para esta propriedade se outro imóvel for nulo.
TaskSequencePackage Identifica uma propriedade como um identificador de pacotes.
VariableName Especifica um nome diferente para a propriedade no ambiente de sequência de tarefas.
PermitidoLen Especifica o número mínimo e máximo de caracteres numa corda.
Códigos de Sucesso Especifica um ou mais código de devolução do executável que indica sucesso.

Restrições

  • Os constrangimentos regulares de qualificação podem ser aplicados às propriedades da classe. Por exemplo, no exemplo acima, os argumentos da linha de comando não podem ser null . Para obter mais informações, consulte o SDK de Instrumentação de Gestão de Windows (WMI).

  • Certifique-se de que os nomes de propriedade e os qualificadores estão sincronizados entre o ficheiro MOF, o controlo de ação personalizado e a aplicação do cliente. Os nomes da propriedade devem corresponder, bem como quaisquer limitações. Por exemplo, se um int imóvel é necessário, e deve estar no intervalo 1 - 512, então o ficheiro MOF deve ter um Not_Null e ValueRange qualificador, o controlo personalizado deve garantir que a propriedade está definida e dentro do alcance, e a aplicação do cliente deve verificar o valor antes de usá-lo.

Consulte também

Sobre as ações personalizadas do gestor de configuração
Como criar um controlador de configuração controlo de ação personalizado
Como criar um ficheiro MOF para uma ação personalizada do gestor de configuração
Como utilizar variáveis de sequência de tarefas numa sequência de tarefas do gestor de configuração em execução
Sobre aplicações personalizadas de clientes de ação personalizada do gestor de configuração