Informazioni sulle applicazioni client di azioni personalizzate di Configuration Manager

La sequenza di attività in Configuration Manager esegue operazioni di azione personalizzate durante la distribuzione del client. L'applicazione può essere un processo, uno script o altri comandi. I requisiti per l'applicazione sono definiti in un file MOF (Managed Object Format). I requisiti di esempio includono l'ambiente operativo, gli argomenti della riga di comando, le proprietà e i codici restituiti. Vengono aggiunti all'ambiente della sequenza di attività quando l'azione viene elaborata.

Azione personalizzata file MOF

Il file MOF per un'azione personalizzata è simile all'esempio seguente:

[   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";
};

Il file MOF descrive le informazioni necessarie per l'input dell'applicazione dell'azione personalizzata, l'ambiente, le proprietà e le informazioni sul pacchetto di distribuzione.

Per altre informazioni, vedere Informazioni sul file MOF dell'azione personalizzata di Configuration Manager.

Input applicazione

Le azioni personalizzate devono essere eseguite automaticamente, quindi l'applicazione non deve richiedere l'input dell'utente. Tutti gli input devono essere ricevuti dalla riga di comando, dall'ambiente della sequenza di attività o da un file di dati.

La riga di comando per l'applicazione di azione viene impostata nel file MOF usando l'azione predefinita Esegui riga di comando .

Ad esempio:

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

Elaborazione delle applicazioni

L'applicazione della sequenza di attività esegue le operazioni di azione personalizzate. Deve essere consapevole del proprio ambiente operativo e avere accesso alle variabili di ambiente di sequenziazione delle attività, segnalare lo stato di avanzamento e restituire i codici di completamento.

Ambiente

Il file MOF deve specificare l'ambiente operativo con la proprietà SMS_TaskSequence_Action Server WMI ClassSupportedEnvironment . Gli ambienti disponibili sono Windows PE (WinPE), sistema operativo completo (FullOS) o entrambi gli ambienti (WinPEandFullOS).

La scelta dell'ambiente dipende dalle circostanze. Ad esempio, la configurazione dell'installazione pre-operativa verrà probabilmente eseguita nell'ambiente Windows PE. Per altre informazioni, vedere Requisiti dell'infrastruttura per la distribuzione del sistema operativo. Aggiornamenti ai sistemi operativi attualmente installati useranno l'ambiente completo del sistema operativo. Ad esempio, l'installazione di software o driver. Le attività indipendenti dall'ambiente del sistema operativo, come i riavvii o la creazione di connessioni di rete, possono essere eseguite utilizzando entrambe le impostazioni di ambiente.

Elaborazione

Durante l'elaborazione, è possibile accedere alle variabili della sequenza di attività definite dal file MOF usando l'oggetto TSEnvironment di automazione COM. Per altre informazioni, vedere Come usare le variabili della sequenza di attività in una sequenza di attività di Configuration Manager in esecuzione.

Se l'operazione richiede molto tempo, è possibile segnalare lo stato di avanzamento all'ambiente della sequenza di attività e visualizzare un indicatore di stato usando la classe di automazione COM del client ProgressUI. Per altre informazioni, vedere Informazioni sulla creazione di report sullo stato di avanzamento delle azioni personalizzate di Configuration Manager.

Completamento

Al termine, l'applicazione deve impostare la variabile di SuccessCodes ambiente come valore restituito.

Se è necessario un riavvio al termine dell'applicazione, è necessario impostare la variabile di SMSTSRebootRequested ambiente. Per altre informazioni, vedere Variabili della sequenza di attività. Per informazioni sull'impostazione delle variabili di ambiente, vedere Come usare le variabili della sequenza di attività in una sequenza di attività di Configuration Manager in esecuzione.

Distribuzione

Per essere utilizzata da Configuration Manager, l'applicazione azione personalizzata deve essere disponibile da un pacchetto di Configuration Manager. L'amministratore può creare il pacchetto usando la console di Configuration Manager o un linguaggio di programmazione. Per altre informazioni, vedere Come creare un pacchetto.

L'identificatore del pacchetto deve essere disponibile per il funzionamento della distribuzione. In genere il file MOF dichiara una proprietà per contenerlo, come nell'esempio seguente:

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

L'identificatore del pacchetto viene ottenuto dall'amministratore quando l'azione personalizzata viene modificata nell'editor della sequenza di attività.

Per abilitare questo comportamento, il controllo azione personalizzato può usare un controllo di modifica del testo nella sua implementazione per ottenere l'identificatore del pacchetto dall'amministratore. Per un esempio che usa un controllo testo, vedere Come creare un controllo azione personalizzato di Configuration Manager.

Quando viene usato dall'amministratore, il controllo azione personalizzato viene modificato come parte di una sequenza di attività usando l'editor della sequenza di attività. Quando viene salvata dall'editor della sequenza di attività, viene creata una classe WMI del server SMS_TaskSequencePackage per contenere la sequenza di attività, inclusa l'azione personalizzata.

Il pacchetto della sequenza di attività viene quindi annunciato ai client insieme al pacchetto di azioni personalizzato a cui fa riferimento l'azione personalizzata. Per ulteriori informazioni, vedere Come creare un annuncio pubblicitario.

Quando l'azione personalizzata viene eseguita nel client, l'identificatore del pacchetto per l'azione personalizzata viene fornito come parametro della riga di comando, da cui vengono estratti ed eseguiti i file binari per l'azione personalizzata.

L'identificatore del pacchetto viene fornito usando il parametro della /run riga di comando per Smsswd.exe.

Configurazione della partizione di pre-rete e della pre-partizione

Se è necessario configurare la connettività del disco o della rete prima di avere una partizione del disco e prima di avere la connettività di rete, è necessario creare un'applicazione per eseguire queste attività. L'applicazione deve essere inserita in un'immagine di avvio personalizzata usando Windows Assessment and Deployment Kit (ADK). Per altre informazioni, vedere Scenari di Windows ADK per i professionisti IT.

Importare quindi l'immagine in Configuration Manager come immagine personalizzata. Per ulteriori informazioni, vedere Aggiungere un'immagine di avvio.

L'applicazione, gli eventuali file di supporto e il SMSTS.INI personalizzato devono essere inseriti nella cartella Windows.

Per utilizzare l'applicazione, utilizzare l'immagine di avvio personalizzata in una sequenza di attività che contiene un passaggio di pre-partizione/rete.

Vedere anche

Informazioni sulle azioni personalizzate di Configuration Manager

Informazioni sul file MOF dell'azione personalizzata di Configuration Manager