Ingebouwde takenreeksvariabelen in Configuration Manager

 

Van toepassing op: 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

Ingebouwde variabelen voor de takenreeks worden geleverd door System Center 2012 Configuration Manager. Ingebouwde variabelen bieden informatie over de omgeving waarin de takenreeks wordt uitgevoerd, en hun waarden zijn beschikbaar in de hele takenreeks. Meestal worden ingebouwde variabelen geïnitialiseerd voordat de stappen worden uitgevoerd in de takenreeks. De ingebouwde variabele _SMSTSLogPath is bijvoorbeeld een omgevingsvariabele die het pad specificeert dat Configuration Manager-onderdelen gebruiken om logboekbestanden te schrijven, terwijl de takenreeks wordt uitgevoerd. Elke takenreeks heeft toegang tot deze omgevingsvariabele. Sommige variabelen, zoals _SMSTSCurrentActionName, worden echter geëvalueerd voor elke stap. De waarden van ingebouwde variabelen zijn doorgaans alleen-lezen. De waarden zijn alleen-lezen voor ingebouwde variabelen met een naam die met een onderstrepingsteken begint.

Lijst met ingebouwde variabelen voor takenreeksen

De volgende lijst bevat de ingebouwde variabelen die beschikbaar zijn in Configuration Manager:

Naam ingebouwde variabele	Beschrijving
_SMSTSAdvertID	Slaat de unieke id van de huidige actieve takenreeksimplementatie op. Deze maakt gebruik van dezelfde indeling als een softwaredistributie-implementatie-id voor Configuration Manager. Deze variabele is niet gedefinieerd, als de takenreeks wordt uitgevoerd op zelfstandige media. Voorbeeld: ABC20001
_TSAppInstallStatus	Voor System Center 2012 R2 Configuration Manager en later: De takenreeks stelt de variabele _TSAppInstallStatus in met de installatiestatus voor de toepassing tijdens de takenreeksstap Toepassing installeren. De takenreeks stelt de variabele in met een van de volgende waarden: Niet gedefinieerd: Instellen wanneer de takenreeksstap Toepassing installeren niet is uitgevoerd. Fout: Instellen wanneer ten minste één toepassing is mislukt vanwege een fout tijdens de takenreeksstap Toepassing installeren. Waarschuwing: Instellen wanneer er geen fouten zijn opgetreden tijdens de takenreeksstap Toepassing installeren, maar een of meerdere toepassingen, of een vereiste afhankelijkheid, niet werden geïnstalleerd omdat er niet werd voldaan aan een vereiste. Geslaagd: Instellen wanneer er geen fouten of waarschuwing zijn gedetecteerd tijdens de takenreeksstap Toepassing installeren.
_SMSTSBootImageID	Slaat de pakket-id van de Configuration Manager-installatiekopie op die is gekoppeld aan de huidige actieve takenreeks. De variabele wordt worden niet ingesteld als er geen Configuration Manager-installatiekopiepakket is gekoppeld. Voorbeeld: ABC00001
_SMSTSBootUEFI	Voor System Center 2012 Configuration Manager SP1 en later: De takenreeks stelt de variabele SMSTSBootUEFI in wanneer er wordt gedetecteerd dat een computer in de UEFI-modus staat.
_SMSTSClientGUID	Slaat de waarde op van Configuration Manager-client-GUID. Deze variabele is niet ingesteld als de takenreeks wordt uitgevoerd op zelfstandige media. Voorbeeld: 0a1a9a4b-fc56-44f6-b7cd-c3f8ee37c04c
_SMSTSCurrentActionName	Hiermee geeft u de naam op van de huidige actieve stap van de takenreeks. Deze variabele wordt ingesteld voordat takenreeksbeheer elke afzonderlijke stap uitvoert. Voorbeeld: opdrachtregel uitvoeren
_SMSTSDownloadOnDemand	Ingesteld op true als de huidige takenreeks wordt uitgevoerd in de modus voor downloaden op verzoek, wat betekent dat takenreeksbeheer alleen lokaal inhoud downloadt als deze toegang moet hebben tot de inhoud.
_SMSTSInWinPE	Deze variabele is ingesteld op true wanneer de huidige stap van de takenreeks wordt uitgevoerd in de Windows PE-omgeving, en deze is ingesteld op false als dit niet zo is. U kunt deze variabele voor de takenreeks testen om te bepalen wat de huidige besturingssysteemomgeving is.
_SMSTSLastActionRetCode	Slaat de retourcode op die is geretourneerd door de laatste actie die is uitgevoerd. Deze variabele kan worden gebruikt als een voorwaarde om te bepalen of de volgende stap wordt uitgevoerd. Voorbeeld: 0
_SMSTSLastActionSucceeded	De variabele is ingesteld op true als de laatste actie is geslaagd en op false als de laatste actie is mislukt. Als de laatste actie is overgeslagen omdat de stap was uitgeschakeld of omdat de gekoppelde voorwaarde werd geëvalueerd als false, wordt deze variabele niet opnieuw ingesteld, wat betekent dat deze de waarde voor de vorige actie nog bevat.
_SMSTSLaunchMode	Hiermee geeft u de startmethode voor de takenreeks op. De takenreeks kan de volgende waarden hebben: SMS: geeft aan dat de takenreeksen zijn gestart met behulp van de Configuration Manager-client. UFD: geeft aan dat de takenreeksen zijn gestart met behulp van USB-media en dat de USB-media zijn gemaakt in Windows XP/2003. UFD+FORMAT: geeft aan dat de takenreeksen zijn gestart met behulp van USB-media en dat de USB-media zijn gemaakt in Windows Vista of later. CD: geeft aan dat de takenreeks met een cd is gestart. DVD: geeft aan dat de takenreeks met een dvd is gestart. PXE: geeft aan dat de takenreeks vanaf PXE is gestart. HD: geeft aan dat de takenreeks is gestart vanaf een vaste schijf (alleen voorgefaseerde media).
_SMSTSLogPath	Slaat het volledige pad op van de logboekmap. Dit kan worden gebruikt om te bepalen waar acties worden vastgelegd. Deze waarde wordt niet ingesteld als er geen vaste schijf beschikbaar is.
_SMSTSMachineName	Slaat de computernaam op en specificeert deze. Slaat de naam op van de computer die de takenreeks zal gebruiken om alle statusberichten te registreren. U kunt de naam van de computer in het nieuwe besturingssysteem wijzigen met de variabele OSDComputerName. Voorbeeld: ABC
_SMSTSMDataPath	Hiermee wordt het pad gespecificeerd dat wordt gedefinieerd door de variabele SMSTSLocalDataDrive. Als u SMSTSLocalDataDrive definieert voordat de takenreeks wordt gestart, bijvoorbeeld door een verzamelingsvariabele in te stellen, definieert Configuration Manager de variabele _SMSTSMDataPath zodra de takenreeks wordt gestart.
_SMSTSMediaType	Hiermee wordt het type media opgegeven dat wordt gebruikt om de installatie te starten. Voorbeelden van typen media zijn opstartmedia, volledige media, PXE en voorgefaseerde media.
_SMSTSMP	Slaat de naam of het IP-adres op van een Configuration Manager-beheerpunt.
_SMSTSMPPort	Slaat het poortnummer op van een Configuration Manager-beheerpunt. Voorbeeld: 80
_SMSTSOrgName	Slaat de huisstijl op van de titelnaam die wordt weergegeven in het dialoogvenster van de gebruikersinterface voor de takenreeksvoortgang. Voorbeeld: XYZ organisatie
_SMSTSPackageID	Slaat de id van de huidige actieve takenreeks op. Deze id maakt gebruik van dezelfde indeling als een Configuration Manager-softwarepakket-id. Voorbeeld: HJT00001
_SMSTSPackageName	Slaat de naam op van takenreeks die momenteel actief is, die is opgegeven door de Configuration Manager-beheerder bij het maken van de takenreeksen. Voorbeeld: Takenreeks Windows 7 implementeren
_SMSTSRunFromDP	Ingesteld op true als de huidige takenreeks wordt uitgevoerd vanuit de modus voor het uitvoeren vanaf distributiepunt, wat betekent dat takenreeksbeheer het vereiste pakketshares verkrijgt van een distributiepunt.
_SMSTSSiteCode	Slaat de sitecode op voor de Configuration Manager-site. Voorbeeld: ABC
_SMSTSType	Hiermee geeft u het type op van de huidige actieve takenreeks. Deze kan de volgende waarden hebben: 1 - geeft aan dat het om een algemene takenreeks gaat. 2 - geeft aan dat het om een takenreeks voor implementatie van een besturingssysteem gaat.
_SMSTSTimezone	De variabele _SMSTSTimezone slaat de tijdzonegegevens op in de volgende notatie (zonder spaties): Bias, StandardBias, DaylightBias, StandardDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, DaylightDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, StandardName, DaylightName Voorbeeld: Voor Eastern Time VS en Canada wordt de waarde 300,0,-60,0,11,0,1,2,0,0,0,0,3,0,2,2,0,0,0,Eastern Standard Time,Eastern Daylight Time
_SMSTSUseCRL	Hiermee geeft u op of de takenreeks de certificaatintrekkingslijst gebruikt als deze een Secure Socket Layer-certificaat (SSL) gebruikt om te communiceren met het beheerpunt.
_SMSTSUserStarted	Hiermee geeft u op of een takenreeks door een gebruiker wordt gestart. Deze variabele wordt alleen ingesteld als de takenreeks wordt gestart vanuit het Software Center. Als _SMSTSLaunchMode bijvoorbeeld is ingesteld op SMS. De variabele kan de volgende waarden hebben: true - geeft aan dat de takenreeks handmatig wordt gestart door een gebruiker, vanuit het Software Center. false - geeft aan dat de takenreeks automatisch wordt geïnitieerd door de Configuration Manager-planner.
_SMSTSUseSSL	Geeft aan of de takenreeks SSL gebruikt om te communiceren met het Configuration Manager-beheerpunt. Als uw site in de native-modus wordt uitgevoerd, is de waarde ingesteld op true.
_SMSTSWTG	Voor System Center 2012 Configuration Manager SP1 en later: De variabele specificeert of de computer wordt gebruikt als een Windows To Go-apparaat.
SMSTSAssignmentsDownloadInterval	Voor System Center 2012 Configuration Manager SP1 en later: Gebruik deze variabele om het aantal seconden op te geven dat er na de laatste poging (waarbij geen beleid is geretourneerd) moet worden gewacht voordat de client het beleid probeert te downloaden. De client wacht standaard 0 seconden alvorens het opnieuw te proberen. U kunt deze variabele instellen door een prestart-opdracht te gebruiken vanaf media of PXE.
SMSTSAssignmentsDownloadRetry	Voor System Center 2012 Configuration Manager SP1 en later: Gebruik deze variabele om het aantal pogingen op te geven dat een client kan doen om het beleid te downloaden nadat er bij de eerste poging geen beleid is gevonden. De client onderneemt standaard 0 nieuwe pogingen. U kunt deze variabele instellen door een prestart-opdracht te gebruiken vanaf media of PXE.
SMSTSAssignUsersMode	Hiermee geeft u op hoe een takenreeks gebruikers koppelt aan de doelcomputer. Stel de variabele in op een van de volgende waarden. Automatisch: De takenreeks brengt een relatie tot stand tussen de opgegeven gebruikers en de doelcomputer wanneer deze het besturingssysteem op de doelcomputer implementeert. In behandeling: De takenreeks brengt een relatie tot stand tussen de opgegeven gebruiker en de doelcomputer, maar er wordt gewacht op goedkeuring van de gebruiker met beheerdersrechten voordat de relatie wordt ingesteld. Uitgeschakeld: De takenreeks koppelt geen gebruikers aan de doelcomputer wanneer dit het besturingssysteem implementeert.
SMSTSDownloadProgram	Voor System Center 2012 Configuration Manager SP1 en later: Gebruik deze variabele om in plaats van het standaard Configuration Manager-downloadprogramma voor de takenreeks een alternatieve inhoudprovider (een programma dat wordt gebruikt voor het downloaden van inhoud) op te geven. Als onderdeel van het downloadproces voor inhoud controleert de takenreeks de variabele voor een gespecificeerd downloadprogramma. Als deze is opgegeven, voert de takenreeks het programma uit en wordt de inhoud gedownload.
SMSTSDownloadRetryCount	Voor System Center 2012 R2 Configuration Manager en later: Gebruik deze variabele om het aantal keer te geven dat Configuration Manager probeert inhoud van een distributiepunt te downloaden. De client onderneemt standaard 2 nieuwe pogingen.
SMSTSDownloadRetryDelay	Voor System Center 2012 R2 Configuration Manager en later: Gebruik deze variabele om het aantal seconden te geven dat Configuration Manager wacht voordat het opnieuw probeert inhoud van een distributiepunt te downloaden. De client wacht standaard 15 seconden alvorens het opnieuw te proberen.
SMSTSErrorDialogTimeout	Wanneer een fout optreedt in de taakvolgorde, wordt er een dialoogvenster weergegeven dat door deze variabele na enkele seconden automatisch wordt gesloten. Het dialoogvenster wordt standaard automatisch gesloten na 900 seconden (15 minuten).
TSErrorOnWarning	Voor System Center 2012 R2 Configuration Manager en later: Gebruik deze variabele om op te geven of de takenreeksengine een gedetecteerde waarschuwing opvat als een fout tijdens de taakstap voor de installatie van een toepassing. De taakvolgorde stelt de variabele _TSAppInstallStatus in op Waarschuwing als een of meer toepassingen of een vereiste afhankelijkheid niet zijn geïnstalleerd omdat niet aan een vereiste is voldaan. Als u de variabele TSErrorOnWarning instelt op True en de variabele _TSAppInstallStatus is ingesteld op Waarschuwing, wordt dit beschouwd als een fout. De waarde False is de standaardinstelling.
SMSTSLanguageFolder	Voor System Center 2012 Configuration Manager SP1 en later: Gebruik deze variabele als u de weergavetaal wilt wijzigen van een taalonafhankelijke installatiekopie.
SMSTSLocalDataDrive	Hiermee wordt aangegeven waar tijdelijke bestanden worden opgeslagen op de doelcomputer terwijl de takenreeks wordt uitgevoerd. Deze variabele moet worden ingesteld voordat de takenreeks wordt gestart, bijvoorbeeld door een verzamelingsvariabele in te stellen. Zodra de takenreeks start, definieert Configuration Manager de variabele _SMSTSMDataPath.
SMSTSMPListRequestTimeout	Voor System Center 2012 R2 Configuration Manager en later: Gebruik deze variabele om te specificeren hoeveel milliseconden lang een takenreeks wacht voordat deze opnieuw probeert een toepassing te installeren, nadat het opvragen van de beheerpuntlijst van locatieservices is mislukt. Standaard wacht de takenreeks 60.000 milliseconden (60 seconden) voordat deze de stap opnieuw uitvoert, en er worden drie pogingen gedaan. Deze variabele is enkel van toepassing op de takenreeksstap Toepassing installeren.
SMSTSPersistContent	Voor System Center 2012 Configuration Manager SP1 en later: Gebruik deze variabele als u inhoud tijdelijk in de takenreekscache wilt houden.
SMSTSPostAction	Voor System Center 2012 Configuration Manager SP1 en later: Hiermee geeft u een opdracht die wordt uitgevoerd nadat de takenreeks is voltooid. U kunt deze variabele bijvoorbeeld gebruiken om een script op te geven waarmee schrijffilters op ingesloten apparaten kunnen worden ingeschakeld, nadat de takenreeks een besturingssysteem naar het apparaat heeft geïmplementeerd.
SMSTSPreferredAdvertID	Hiermee wordt een specifieke gerichte implementatie geforceerd op de doelcomputer, zodat deze wordt uitgevoerd. Deze kan worden ingesteld via een prestart-opdracht van media of PXE. Als deze variabele is ingesteld, overschrijft de takenreeks alle vereiste implementaties.
OSDPreserveDriveLetter	Voor System Center 2012 Configuration Manager SP1 en later: Deze variabele bepaalt of de takenreeks de stationsletter gebruikt die is vastgelegd in het WIM-bestand van de installatiekopie van het besturingssysteem, wanneer die installatiekopie wordt toegepast op een doelcomputer. In Configuration Manager zonder service pack, werd de stationsaanduiding in het WIM-bestand gebruikt wanneer dit werd toegepast op het WIM-bestand van de installatiekopie van het besturingssysteem. In Configuration Manager SP1 kunt u de waarde voor deze variabele instellen op False om de locatie te gebruiken die u opgeeft bij de instelling Doel in de takenreeksstap Besturingssysteem toepassen. Zie de sectie Installatiekopie van het besturingssysteem toepassen in het onderwerp Takenreeksstappen in Configuration Manager voor meer informatie over de takenreeksstap Besturingssysteem toepassen.
SMSTSRebootDelay	Hiermee wordt opgegeven hoeveel seconden er wordt gewacht voordat de computer opnieuw wordt opgestart. Het takenreeksbeheer geeft een meldingsdialoogvenster voordat opnieuw wordt opgestart als deze variabele niet is ingesteld op 0. Voorbeelden: 0 30
SMSTSRebootMessage	Hiermee wordt het bericht opgegeven voor het weergeven van het afsluitdialoogvenster als opnieuw opstarten is aangevraagd. Als deze variabele niet is ingesteld, wordt er een standaardbericht weergegeven. Voorbeeld: Deze computer wordt opnieuw opgestart door het takenreeksbeheer.
SMSTSRebootRequested	Geeft aan dat opnieuw opstarten is aangevraagd nadat de huidige takenreeks is voltooid. Als een herstart nodig is, stelt u deze variabele in op true, en start het takenreeksbeheer de computer opnieuw op na deze stap van de takenreeks. De takenreeksstap moet deze takenreeksvariabele instellen als herstart is vereist voor het voltooien van de takenreeksstap. Nadat de computer opnieuw is opgestart, gaat de takenreeks verder vanaf de volgende takenreeksstap.
SMSTSRetryRequested	Hiermee wordt een nieuwe poging aangevraagd nadat de huidige takenreeksstap is voltooid. Als deze takenreeksvariabele is ingesteld, moet SMSTSRebootRequested ook worden ingesteld op true. Nadat de computer opnieuw is opgestart, voert het takenreeksbeheer dezelfde takenreeksstap opnieuw uit.
SMSTSUDAUsers	Geeft de primaire gebruiker van de doelcomputer op. Hiermee worden de gebruikers opgegeven met de volgende notatie. Meerdere gebruikers worden gescheiden door een komma (,). Voorbeeld: domein\gebruiker1, domein\gebruiker2, domein\gebruiker3 Zie Gebruikers koppelen aan een doelcomputer voor meer informatie over koppelen van gebruikers aan de doelcomputer.

Zie ook

Takenreeksvariabelen in Configuration Manager