Variabili predefinite della sequenza di attività in Configuration Manager

 

Si applica a: System Center 2012 Configuration Manager, System Center 2012 Configuration Manager SP1, System Center 2012 Configuration Manager SP2, System Center 2012 R2 Configuration Manager, System Center 2012 R2 Configuration Manager SP1

Le variabili predefinite della sequenza di attività vengono fornite da System Center 2012 Configuration Manager. Le variabili predefinite forniscono informazioni sull'ambiente in cui è in esecuzione la sequenza di attività e i relativi valori sono disponibili nell'intera sequenza di attività. Le variabili predefinite in genere vengono inizializzate prima dell'esecuzione dei passaggi nella sequenza di attività. Ad esempio, la variabile predefinita _SMSTSLogPath è una variabile di ambiente che specifica il percorso usato dai componenti Configuration Manager per scrivere file di log durante le esecuzioni della sequenza di attività; qualsiasi passaggio della sequenza di attività può accedere a questa variabile di ambiente. Alcune variabili, tuttavia, come _SMSTSCurrentActionName, vengono valutate prima di ogni passaggio. I valori delle variabili predefinite sono generalmente di sola lettura. I valori vengono letti solo per le variabili predefinite con un nome che inizia con un carattere di sottolineatura.

Elenco di variabili predefinite della sequenza di attività

Nell'elenco seguente vengono descritte le variabili predefinite disponibili in Configuration Manager:

Nome della variabile predefinita

Descrizione

_SMSTSAdvertID

Archivia l'ID univoco di distribuzione della sequenza di attività. Usa lo stesso formato di un ID di distribuzione software di Configuration Manager. Se la sequenza di attività viene eseguita da un supporto autonomo, la variabile non è definita.

Esempio:

ABC20001

_TSAppInstallStatus

Per System Center 2012 R2 Configuration Manager e versioni successive:

La sequenza di attività imposta la variabile _TSAppInstallStatus con lo stato di installazione dell'applicazione durante il passaggio Installa applicazione della sequenza di attività. La sequenza di attività imposta la variabile su uno dei seguenti valori:

  1. Non definito: impostato quando il passaggio Installa applicazione della sequenza di attività non è stato eseguito.

  2. Errore: impostato quando non è possibile eseguire almeno un'applicazione a causa di un errore durante il passaggio Installa applicazione della sequenza di attività.

  3. Avviso: impostato quando non si verificano errori durante il passaggio Installa applicazione della sequenza di attività, ma una o più applicazioni oppure una dipendenza richiesta non vengono installate perché non è stato soddisfatto un requisito.

  4. Operazione riuscita: impostato quando non vengono rilevati errori o avvisi durante il passaggio Installa applicazione della sequenza di attività.

_SMSTSBootImageID

Archivia l'ID pacchetto dell'immagine d'avvio di Configuration Manager se un pacchetto di immagini d'avvio è associato alla sequenza di attività attualmente in esecuzione. La variabile non verrà impostata se non è associato alcun pacchetto di immagini d'avvio di Configuration Manager.

Esempio:

ABC00001

_SMSTSBootUEFI

per System Center 2012 Configuration Manager SP1 e versioni successive:

La sequenza di attività imposta la variabile SMSTSBootUEFI quando rileva un computer in modalità UEFI.

_SMSTSClientGUID

Archivia il valore del GUID client di Configuration Manager. Questa variabile non è impostata se la sequenza di attività viene eseguita da un supporto autonomo.

Esempio:

0a1a9a4b-fc56-44f6-b7cd-c3f8ee37c04c

_SMSTSCurrentActionName

Specifica il nome del passaggio della sequenza di attività attualmente in esecuzione. Questa variabile viene impostata prima che il motore di esecuzione della sequenza di attività esegua ogni singolo passaggio.

Esempio:

esegui riga di comando

_SMSTSDownloadOnDemand

Impostare su true se la sequenza di attività corrente è in esecuzione in modalità di download su richiesta, ovvero il motore di esecuzione della sequenza di attività scarica il contenuto localmente solo quando deve accedere al contenuto.

_SMSTSInWinPE

Questa variabile è impostata su true quando il passaggio della sequenza di attività corrente è in esecuzione nell'ambiente Windows PE, mentre viene impostata su false in caso contrario. È possibile testare questa variabile della sequenza di attività per determinare l'ambiente del sistema operativo corrente.

_SMSTSLastActionRetCode

Archivia il codice restituito che è stato restituito dall'ultima azione eseguita. Questa variabile può essere usata come condizione per determinare se il passaggio successivo viene eseguito.

Esempio:

0

_SMSTSLastActionSucceeded

La variabile è impostata su true se l'ultima azione ha esito positivo e su false se l'ultima azione non è riuscita. Se l'ultima azione è stata ignorata perché il passaggio è stato disabilitato o la condizione associata viene valutata false, questa variabile non viene reimpostata, quindi contiene ancora il valore per l'azione precedente.

_SMSTSLaunchMode

Specifica il metodo di avvio della sequenza di attività. La sequenza di attività può avere i seguenti valori:

  • SMS: specifica che la sequenza di attività viene avviata tramite il client Configuration Manager

  • UFD: specifica che la sequenza di attività viene avviata usando supporti USB e che il supporto USB è stato creato in Windows XP/2003.

  • UFD+FORMAT: specifica che la sequenza di attività viene avviata usando supporti USB e che sia stato creato il supporto USB in Windows Vista o versione successiva.

  • CD: specifica che la sequenza di attività venga avviata tramite un CD.

  • DVD: specifica che la sequenza di attività venga avviata tramite un DVD.

  • PXE: specifica che la sequenza di attività venga avviata tramite PXE.

  • HD: specifica che la sequenza di attività venga avviata da un disco rigido (solo supporti pre-installati).

_SMSTSLogPath

Archivia il percorso completo della directory di log. Può essere usato per determinare la posizione in cui sono registrate le azioni. Questo valore non è impostato quando non è disponibile un disco rigido.

_SMSTSMachineName

Archivia e specifica il nome del computer. Archivia il nome del computer che verrà usata dalla sequenza di attività per registrare tutti i messaggio di stato. Per modificar il nome computer nel nuovo sistema operativo, usare la variabile OSDComputerName.

Esempio:

ABC

_SMSTSMDataPath

Specifica il percorso definito dalla variabile SMSTSLocalDataDrive. Quando si definisce SMSTSLocalDataDrive prima dell'inizio della sequenza di attività, ad esempio impostando una variabile di raccolta, Configuration Manager definisce la variabile _SMSTSMDataPath una volta avviata la sequenza di attività.

_SMSTSMediaType

Specifica il tipo di supporto usato per avviare l'installazione. Esempi di tipi di supporto sono supporti di avvio, supporti completi, PXE e supporti pre-installati.

_SMSTSMP

Archivia il nome o l'indirizzo IP di un punto di gestione di Configuration Manager.

_SMSTSMPPort

Archivia il numero di porta di un punto di gestione di Configuration Manager.

Esempio:

80

_SMSTSOrgName

Archivia il nome titolo personalizzazione che viene visualizzato in una finestra di dialogo di interfaccia utente relativa all'avanzamento della sequenza di attività.

Esempio:

Organizzazione XYZ

_SMSTSPackageID

Archivia l'ID della sequenza di attività in esecuzione. L'ID usa lo stesso formato dell'ID del pacchetto software di Configuration Manager.

Esempio:

HJT00001

_SMSTSPackageName

Archivia il nome della sequenza di attività attualmente in esecuzione specificato dall'amministratore di Configuration Manager quando viene creata la sequenza di attività.

Esempio:

Distribuire la sequenza di attività di Windows 7

_SMSTSRunFromDP

Impostare su true se la sequenza di attività corrente è in esecuzione in modalità di esecuzione da punto di distribuzione, cioè il motore di esecuzione della sequenza di attività ottiene le condivisioni pacchetto richieste dal punto di distribuzione.

_SMSTSSiteCode

Archivia il codice del sito Configuration Manager.

Esempio:

ABC

_SMSTSType

Specifica il tipo di sequenza di attività attualmente in esecuzione. Se son presenti i seguenti valori:

1: indica una sequenza di attività generiche.

2: indica una sequenza di attività di distribuzione del sistema operativo.

_SMSTSTimezone

La variabile _SMSTSTimezone archivia le informazioni sul fuso orario nel seguente formato (senza spazi):

Bias, StandardBias, DaylightBias, StandardDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, DaylightDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, StandardName, DaylightName

Esempio:

Per l'orario della costa orientale degli Stati Uniti e del Canada, il valore sarà 300,0,-60,0,11,0,1,2,0,0,0,0,3,0,2,2,0,0,0,Ora solare fuso orientale,Ora legale fuso orientale 

_SMSTSUseCRL

Specifica se la sequenza di attività usa l'elenco di revoche di certificati quando usa un certificato Secure Socket Layer (SSL) per comunicare con il punto di gestione.

_SMSTSUserStarted

Specifica se una sequenza di attività viene avviata da un CD. Questa variabile viene impostata solo se la sequenza di attività viene eseguita da Software Center. Ad esempio, se _SMSTSLaunchMode è impostato su SMS, la variabile può avere i seguenti valori:

  • true: specifica che la sequenza di attività viene eseguita manualmente da un utente da Software Center.

  • false: specifica che la sequenza di attività viene avviata automaticamente dall'utilità di pianificazione di Configuration Manager.

_SMSTSUseSSL

Specifica se la sequenza di attività usa SSL per comunicare con il punto di gestione di Configuration Manager. Se il sito è in esecuzione in modalità nativa, il valore è impostato su true.

_SMSTSWTG

per System Center 2012 Configuration Manager SP1 e versioni successive:

specifica se il computer è in esecuzione come dispositivo Windows To Go.

SMSTSAssignmentsDownloadInterval

per System Center 2012 Configuration Manager SP1 e versioni successive:

Usare questa variabile per specificare il numero di secondi di attesa prima che il client provi a eseguire il tentativo di download dei criteri dopo l'ultimo tentativo che non ha restituito alcun criterio. Per impostazione predefinita, il client attenderà 0 secondi prima di riprovare.

È possibile impostare questa variabile usando un comando di preavvio da un supporto o da PXE.

SMSTSAssignmentsDownloadRetry

per System Center 2012 Configuration Manager SP1 e versioni successive:

usare questa variabile per specificare il numero di tentativi di download dei criteri da parte del client dopo che durante il primo tentativo non è stato rilevato alcun criterio. Per impostazione predefinita, il client riproverà 0 secondi.

È possibile impostare questa variabile usando un comando di preavvio da un supporto o da PXE.

SMSTSAssignUsersMode

Specifica in che modo una sequenza di attività associa gli utenti al computer di destinazione. Impostare la variabile su uno dei valori seguenti.

  • Auto: la sequenza di attività crea una relazione tra gli utenti specificati e il computer di destinazione quando distribuisce il sistema operativo nel computer di destinazione.

  • In sospeso: la sequenza di attività crea una relazione tra gli utenti specificati e il computer di destinazione, ma attende l'approvazione dell'utente amministratore prima che la relazione venga impostata.

  • Disattivata: la sequenza di attività non associa gli utenti al computer di destinazione quando distribuisce il sistema operativo.

SMSTSDownloadProgram

per System Center 2012 Configuration Manager SP1 e versioni successive:

usare questa variabile per specificare un provider contenuto alternativo, un programma downloader usato per scaricare contenuto invece del downloader predefinito di Configuration Manager per la sequenza di attività. Durante il processo di download di contenuto, la sequenza di attività verifica se nella variabile è indicato un programma downloader specificato. Se specificato, la sequenza di attività esegue il programma per eseguire il download.

SMSTSDownloadRetryCount

Per System Center 2012 R2 Configuration Manager e versioni successive:

usare questa variabile per specificare il numero di tentativi eseguiti da Configuration Manager per scaricare contenuto da un punto di distribuzione. Per impostazione predefinita, il client riproverà 2 volte. 

SMSTSDownloadRetryDelay

Per System Center 2012 R2 Configuration Manager e versioni successive:

usare questa variabile per specificare il numero di secondi di attesa da parte di Configuration Manager prima di eseguire un nuovo tentativo per scaricare contenuto da un punto di distribuzione. Per impostazione predefinita, il client attenderà 15 secondi prima di riprovare.

SMSTSErrorDialogTimeout

Quando si verifica un errore in una sequenza di attività, viene visualizzata una finestra di dialogo che viene ignorata automaticamente dopo un numero di secondi specificato da questa variabile. Per impostazione predefinita, la finestra di dialogo viene ignorata automaticamente dopo 900 secondi (15 minuti).

TSErrorOnWarning

Per System Center 2012 R2 Configuration Manager e versioni successive:

Usare questa variabile per specificare se il motore della sequenza di attività considera un avviso come un errore rilevato durante il passaggio della sequenza di attività relativo all'installazione dell'applicazione. La sequenza di attività imposta la variabile _TSAppInstallStatus su Avviso quando una o più applicazioni o una dipendenza richiesta non viene installata perché non è stato raggiunto un requisito. Quando si imposta la variabile TSErrorOnWarning su True e la variabile _TSAppInstallStatus è impostata su Avviso, l'avviso viene considerato come un errore. Il comportamento predefinito è False.

SMSTSLanguageFolder

per System Center 2012 Configuration Manager SP1 e versioni successive:

usare questa variabile per modificare la lingua di visualizzazione di un'immagine di avvio indipendente dalla lingua.

SMSTSLocalDataDrive

Specifica la posizione del computer di destinazione in cui vengono archiviati i file temporanei durante l'esecuzione della sequenza di attività.

Questa variabile deve essere impostata prima dell'inizio della sequenza di attività, ad esempio impostando una variabile raccolta. Una volta avviata la sequenza di attività, Configuration Manager definisce la variabile _SMSTSMDataPath.

SMSTSMPListRequestTimeout

Per System Center 2012 R2 Configuration Manager e versioni successive:

Usare questa variabile per specificare, in millisecondi, il tempo di attesa di una sequenza di attività prima che riprovi a installare un'applicazione in seguito all'impossibilità di recuperare l'elenco dei punti di gestione dai servizi di posizione. Per impostazione predefinita, la sequenza di attività attende 60.000 millisecondi (60 secondi) prima di riprovare a eseguire il passaggio ed effettua fino a tre tentativi. Questa variabile è applicabile solo al passaggio della sequenza di attività Installa applicazione.

SMSTSPersistContent

per System Center 2012 Configuration Manager SP1 e versioni successive:

usare questa variabile per mantenere temporaneamente il contenuto nella cache della sequenza di attività.

SMSTSPostAction

per System Center 2012 Configuration Manager SP1 e versioni successive:

Specifica un comando che viene eseguito al termine della sequenza di attività. Ad esempio, è possibile usare questa variabile per specificare uno script che abilita i filtri di scrittura nei dispositivi incorporati dopo che la sequenza di attività distribuisce un sistema operativo nel dispositivo.

SMSTSPreferredAdvertID

Forza una distribuzione di destinazione specifica sul computer di destinazione da eseguire. Può essere impostata tramite un comando di preavvio dai supporti o da PXE. Se questa variabile viene impostata, la sequenza di attività esegue l'override di tutte le distribuzioni richieste.

OSDPreserveDriveLetter

per System Center 2012 Configuration Manager SP1 e versioni successive:

Questa variabile determina se la sequenza di attività usa la lettera di unità acquisita nel file WIM dell'immagine del sistema operativo quando si applica tale immagine a un computer di destinazione. In Configuration Manager senza Service Pack la lettera di unità specificata nel file WIM viene usata quando si applica il file WIM dell'immagine del sistema operativo. In Configuration Manager SP1, è possibile impostare il valore per questa variabile su False per usare il percorso specificato per l'impostazione Destinazione nel passaggio sequenza di attività Applica sistema operativo. Per altre informazioni sul passaggio della sequenza di attività Applica sistema operativo, vedere la sezione Applica immagine del sistema operativonell'argomento Procedura della sequenza di attività in Configuration Manager.

SMSTSRebootDelay

Specifica il tempo di attesa in secondi prima del riavvio del computer. Se questa variabile non è impostata su 0, motore di esecuzione della sequenza di attività visualizzerà una finestra di dialogo di notifica prima del riavvio.

Esempi:

0

30

SMSTSRebootMessage

Specifica il messaggio da visualizzare nella finestra di dialogo arresto quando viene richiesto un riavvio. Se questa variabile non è impostata, verrà visualizzato un messaggio predefinito.

Esempio:

Il computer è in fase di riavvio da parte del motore di esecuzione della sequenza di attività.

SMSTSRebootRequested

Indica che un riavvio è richiesto al termine del passaggio della sequenza di attività corrente. Se è necessario un riavvio, è sufficiente impostare questa variabile su true affinché il motore di esecuzione della sequenza di attività riavvii il computer dopo questo passaggio della sequenza di attività. Il passaggio della sequenza di attività deve impostare questa variabile della sequenza di attività se è necessario il riavvio per completare tale passaggio. Dopo il riavvio del computer, la sequenza di attività continuerà a essere eseguita dal passaggio successivo della sequenza di attività.

SMSTSRetryRequested

Richiede un nuovo tentativo dopo il completamento del passaggio della sequenza di attività. Se questa variabile della sequenza di attività è impostata, anche SMSTSRebootRequested deve essere impostata su true. Dopo il riavvio del computer, il motore di esecuzione della sequenza di attività ripeterà lo stesso passaggio della sequenza di attività.

SMSTSUDAUsers

Specifica l'utente primario del computer di destinazione. Specificare gli utenti usando il formato seguente. Separare più utenti mediante una virgola (,).

Esempio:

dominio\utenter1, dominio\utente2, dominio\utente3

Per altre informazioni sull'associazione di utenti al computer di destinazione, vedere Come associare gli utenti a un computer di destinazione.