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

In Configuration Manager è possibile creare, ottenere e impostare 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à. È anche possibile accedervi, all'interno di una sequenza di attività in esecuzione, usando qualsiasi ambiente di programmazione in grado di usare oggetti di automazione COM.

Nota

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

Per creare una variabile della sequenza di attività personalizzata, impostare una Microsoft.SMS.TSEnvironment proprietà usando il nome della nuova variabile che si desidera creare. Se la variabile non esiste già, viene creata. Se la variabile esiste già, il relativo 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 è una matrice di SMS_TaskSequencePartitionSettings. L'esempio seguente rappresenta una matrice di un elemento OSDPartitions :

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

Per accedere FileSystem a in questa matrice, è necessario usare OSDPartitions0FileSystem. Se la matrice è più grande, usareOSDPartitions1FileSystem per il secondo elemento e così via tramite la matrice.

Non è consigliabile usare 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 necessaria dipende dalla versione di Visual Studio usata.

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 gli elementi seguenti:

  • 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 necessaria.

Esempio

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

Per informazioni sulla chiamata del codice di esempio, vedere Chiamata di frammenti di codice 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 Configuration Manager, vedere Configuration Manager'amministrazione basata sui ruoli.

Vedere anche

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