Come usare le variabili della sequenza di attività in una sequenza di attività di Configuration Manager in esecuzione

In Configuration Manager puoi creare, ottenere e impostare le variabili della sequenza di attività in una sequenza di attività in esecuzione usando l'oggetto di automazione COM () dell'ambiente della sequenza di attività (Microsoft.SMS.TSEnvironment).

In genere, si usa un'azione della riga di comando che esegue uno script per accedere alle variabili della sequenza di attività. Tuttavia, è anche possibile accedervi, all'interno di una sequenza di attività in esecuzione, utilizzando qualsiasi ambiente di programmazione in grado di utilizzare oggetti di automazione COM.

Nota

Quando si imposta una variabile di attività nel client di Configuration Manager, questa diventa disponibile per i passaggi successivi della sequenza di attività.

Per creare una variabile personalizzata della sequenza di attività, impostare una Microsoft.SMS.TSEnvironment proprietà usando il nome della nuova variabile che si vuole creare. Se la variabile non esiste già, viene creata. Se la variabile esiste già, il suo valore viene aggiornato. In seguito è possibile ottenere il valore della variabile personalizzata da Microsoft.SMS.TSEnvironment.

Quando una variabile della sequenza di attività è una matrice, viene passata nel formato seguente:

<base array name><element #><Property>="value".

Ad esempio, la OSDPartitions variabile è un array di SMS_TaskSequencePartitionSettings. L'esempio seguente rappresenta una matrice a un elemento OSDPartitions :

OSDPartitions0Bootable="true"
OSDPartitions0FileSystem="NTFS"
OSDPartition0QuickFormat="false"
OSDPartitions0Size="100"
OSDPartitions0SizeUnits="Percent"
OSDPartitions0Type="Primary"

Per accedere FileSystem in questa matrice, usare OSDPartitions0FileSystem. Se la matrice è più grande, la si può usareOSDPartitions1FileSystem per il secondo elemento e così via nella matrice.

Non è consigliabile usare il codice gestito con l'ambiente di sequenziazione delle attività perché non è possibile usarlo negli ambienti seguenti:

  • Windows PE

  • Windows Server 2008

  • Windows 2000

    Il codice gestito funziona quando il sistema operativo completo è in esecuzione con la versione corretta di .NET Framework installata.

    La versione di .NET Framework richiesta dipende dalla versione di Visual Studio in uso.

Visual Studio Versione di .NET Framework
Visual Studio 2003 1.0
Visual Studio 2005 2.0
Visual Studio 2008 Da 2.0 a 3.5

Per accedere all'oggetto è necessario usare l'interoperabilità TSEnvironment COM. Sono necessari i seguenti elementi:

  • Riferimento alla libreria dei tipi TSEnvironment 1.0.

  • Spazio dei nomi TSEnvironmentLib .

Per usare le variabili di attività in una sequenza di attività in esecuzione

  1. In una sequenza di attività in esecuzione creare un'istanza di Microsoft.SMS.TSEnvironment.

  2. Ottenere o impostare la variabile di ambiente richiesta.

Esempio

Il metodo di esempio seguente ottiene la _SMSTSLogPath variabile. Imposta anche il valore di una variabile personalizzata e un valore di variabile personalizzata di matrice.

Per informazioni sulla chiamata del codice di esempio, vedere Chiamata di frammenti di codice di Configuration Manager.

Sub UseTaskSequenceVariables()
   dim osd: set env = CreateObject("Microsoft.SMS.TSEnvironment")
   dim logPath

   ' You can query the environment to get an existing variable.
   logPath = env("_SMSTSLogPath")

    wscript.echo logPath

   ' You can also set a variable in the Operating System Deployment environment.
   env("MyCustomVariable") = "My Custom Value"

   ' Set the OSDPartitions(0) Bootable array member to 0.
    env("OSDPartitions0Bootable") = "true"
End Sub

Compilazione del codice

Piattaforme

Ambiente di sequenziazione delle attività di distribuzione del sistema operativo

Programmazione efficiente

Per altre informazioni sulla gestione degli errori, vedere Informazioni sugli errori di Configuration Manager.

Sicurezza di .NET Framework

Per altre informazioni sulla protezione delle applicazioni di Configuration Manager, vedere Amministrazione basata sui ruoli di Configuration Manager.

Vedere anche

Panoramica degli oggettiCome connettersi a un provider SMS in Configuration Manager tramite codice gestitoCome connettersi a un provider SMS in Configuration Manager tramite WMIPanoramica della sequenza di attivitàCome impostare una variabile della sequenza di attività di distribuzione del sistema operativo