Parameters en eigenschappen van clientinstallatie in Configuration Manager

Van toepassing op: Configuration Manager (current branch)

Gebruik de opdracht CCMSetup.exe om de Configuration Manager client te installeren. Als u clientinstallatieparameters opgeeft op de opdrachtregel, wijzigen deze het installatiegedrag. Als u clientinstallatie-eigenschappen opgeeft op de opdrachtregel, wijzigen deze de initiële configuratie van de geïnstalleerde clientagent.

Over CCMSetup.exe

Met de opdracht CCMSetup.exe downloadt u de benodigde bestanden om de client te installeren vanaf een beheerpunt of bronlocatie. Deze bestanden kunnen het volgende bevatten:

• Het Windows Installer-pakket client.msi dat de clientsoftware installeert

• Clientvereisten

• Updates en oplossingen voor de Configuration Manager-client

CCMSetup.exe biedt opdrachtregelparameters om de installatie aan te passen. Parameters worden voorafgegaan door een slash (/) en zijn meestal kleine letters. U geeft zo nodig de waarde van een parameter op door gebruik te maken van een dubbele punt (:), direct gevolgd door de waarde. Zie CCMSetup.exe opdrachtregelparameters voor meer informatie.

U kunt ook eigenschappen opgeven op de CCMSetup.exe opdrachtregel om het gedrag van client.msi aan te passen. Eigenschappen volgens afspraak zijn hoofdletters. U geeft een waarde voor een eigenschap op met een gelijkteken (=), direct gevolgd door de waarde. Zie Client.msi eigenschappen voor meer informatie.

CCMSetup.exe en de ondersteunende bestanden bevinden zich op de siteserver in de map Client van de installatiemap van de Configuration Manager installatiemap. Configuration Manager deelt deze map met het netwerk onder de siteshare. Bijvoorbeeld \\SiteServer\SMS_ABC\Client.

Achter de opdrachtprompt gebruikt de opdracht CCMSetup.exe de volgende indeling:

CCMSetup.exe [<Ccmsetup parameters>] [<client.msi setup properties>]

Bijvoorbeeld:

CCMSetup.exe /mp:SMSMP01 /logon SMSSITECODE=S01 FSP=SMSFSP01

In dit voorbeeld worden de volgende dingen gedaan:

• Hiermee geeft u het beheerpunt met de naam SMSMP01 op dat u een lijst met distributiepunten wilt aanvragen voor het downloaden van de installatiebestanden van de client.

• Hiermee geeft u op dat de installatie moet stoppen als er al een versie van de client op de computer bestaat.

• Hiermee geeft u client.msi opdracht om de sitecode S01 aan de client toe te wijzen.

• Hiermee wordt client.msi geïnstrueerd om het terugvalstatuspunt met de naam SMSFP01 te gebruiken.

Als u het Active Directory-schema uitbreidt voor Configuration Manager, publiceert de site veel eigenschappen van clientinstallatie in Active Directory Domain Services. De Configuration Manager-client leest deze eigenschappen automatisch. Zie Informatie over eigenschappen van clientinstallatie die worden gepubliceerd naar Active Directory Domain Services voor meer informatie

CCMSetup.exe opdrachtregelparameters

/?

Hier ziet u de beschikbare opdrachtregelparameters voor ccmsetup.exe.

Voorbeeld: ccmsetup.exe /?

/AllowMetered

Gebruik deze parameter om het gedrag van de client in een netwerk met datalimiet te regelen. Deze parameter heeft geen waarden. Wanneer u clientcommunicatie op een netwerk met datalimiet toestaat voor ccmsetup, wordt de inhoud gedownload, wordt deze geregistreerd bij de site en wordt het oorspronkelijke beleid gedownload. Alle verdere communicatie met de client volgt op de configuratie van de clientinstelling uit dat beleid. Zie Over clientinstellingen voor meer informatie.

Als u de client opnieuw installeert op een bestaand apparaat, wordt de volgende prioriteit gebruikt om de configuratie te bepalen:

1. Bestaand beleid voor lokale clients
2. De laatste opdrachtregel die is opgeslagen in het Windows-register
3. Parameters op de ccmsetup-opdrachtregel

/AlwaysExcludeUpgrade

Met deze parameter wordt aangegeven of een client automatisch wordt bijgewerkt wanneer u Automatisch upgraden inschakelt.

Ondersteunde waarden:

• TRUE: de client wordt niet automatisch bijgewerkt
• FALSE: de client wordt automatisch bijgewerkt (standaard)

Bijvoorbeeld:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

Zie Uitgebreide interoperabiliteitsclient voor meer informatie.

/BITSPriority

Wanneer het apparaat clientinstallatiebestanden downloadt via een HTTP-verbinding, kunt u deze parameter gebruiken om de downloadprioriteit op te geven. Geef een van de volgende mogelijke waarden op:

• FOREGROUND

• HIGH

• NORMAL (standaard)

• LOW

Voorbeeld: ccmsetup.exe /BITSPriority:HIGH

/config

Met deze parameter geeft u een tekstbestand op met de installatie-eigenschappen van de client.

• Als CCMSetup als een service wordt uitgevoerd, plaatst u dit bestand in de systeemmap CCMSetup: %Windir%\Ccmsetup.

• Als u de /noservice parameter hebt opgegeven, moet u het bestand in dezelfde map plaatsen als de map CCMSetup.exe.

Voorbeeld: CCMSetup.exe /config:"configuration file name.txt"

Voor de juiste bestandsindeling gebruikt u het bestand mobileclienttemplate.tcf in de \bin\<platform> map in de installatiemap van Configuration Manager op de siteserver. Dit bestand bevat opmerkingen over de secties en het gebruik ervan. Geef de eigenschappen van de clientinstallatie op in de [Client Install] sectie na de volgende tekst: Install=INSTALL=ALL.

Voorbeeld [Client Install] van sectie-item: Install=INSTALL=ALL SMSSITECODE=ABC SMSCACHESIZE=100

/downloadtimeout

Als CCMSetup de installatiebestanden van de client niet kan downloaden, geeft deze parameter de maximale time-out in minuten aan. Na deze time-out stopt CCMSetup met het downloaden van de installatiebestanden. De standaardwaarde is 1440 minuten (één dag).

Gebruik de /retry parameter om het interval tussen herhalingspogingen op te geven.

Voorbeeld: ccmsetup.exe /downloadtimeout:100

/ExcludeFeatures

Deze parameter geeft aan dat CCMSetup.exe de opgegeven functie niet installeert.

Voorbeeld: CCMSetup.exe /ExcludeFeatures:ClientUI Software Center wordt niet geïnstalleerd op de client.

/forceinstall

Geef op dat CCMSetup.exe een bestaande client verwijdert en een nieuwe client installeert.

/forcereboot

Gebruik deze parameter om de computer zo nodig geforceerd opnieuw op te starten om de installatie te voltooien. Als u deze parameter niet opgeeft, wordt CCMSetup afgesloten wanneer u opnieuw moet opstarten. Het gaat dan verder na de volgende handmatige herstart.

Voorbeeld: CCMSetup.exe /forcereboot

/logon

Als er al een versie van de client is geïnstalleerd, geeft deze parameter aan dat de installatie van de client moet worden gestopt.

Voorbeeld: ccmsetup.exe /logon

/mp

Hiermee geeft u een beheerpunt op dat door clients kan worden gebruikt om het dichtstbijzijnde distributiepunt voor de clientinstallatiebestanden te vinden. Als er geen distributiepunten zijn of als computers na vier uur de bestanden van de distributiepunten niet kunnen downloaden, downloaden ze de bestanden vanaf het opgegeven beheerpunt.

Zie Boundary groups - client installation (Grensgroepen - clientinstallatie) voor meer informatie over de manier waarop ccmsetup inhoud downloadt. Dit artikel bevat ook informatie over het gedrag van ccmsetup als u zowel parameters /mp als /source parameters gebruikt.

Computers downloaden de bestanden via een HTTP- of HTTPS-verbinding, afhankelijk van de configuratie van de sitesysteemrol voor clientverbindingen. De download kan ook gebruikmaken van BITS-beperking als u deze configureert. Als u alle distributiepunten en beheerpunten alleen voor HTTPS-clientverbindingen configureert, controleert u of de clientcomputer over een geldig clientcertificaat beschikt.

U kunt de /mp opdrachtregelparameter gebruiken om meer dan één beheerpunt op te geven. Als de computer geen verbinding kan maken met het eerste programma, probeert het tweede programma in de opgegeven lijst. Wanneer u meerdere beheerpunten opgeeft, scheidt u de waarden met puntkomma's.

Als de client via HTTPS verbinding maakt met een beheerpunt, geeft u de FQDN op, niet de computernaam. De waarde moet overeenkomen met het onderwerp of de alternatieve naam van het PKI-certificaat van het managementpunt. Hoewel Configuration Manager het gebruik van een computernaam in het certificaat voor verbindingen op het intranet ondersteunt, wordt het gebruik van een FQDN aanbevolen.

Voorbeeld met de computernaam: ccmsetup.exe /mp:SMSMP01

Voorbeeld met de FQDN: ccmsetup.exe /mp:smsmp01.contoso.com

Met deze parameter kan ook de URL van een CMG (Cloud Management Gateway) worden opgegeven. Gebruik deze URL om de client te installeren op een apparaat met internet. Voer de volgende stappen uit om de waarde voor deze parameter op te halen:

• Maak een CMG. Zie Een CMG instellen voor meer informatie.

• Open op een actieve client een Windows PowerShell-opdrachtprompt als beheerder.

• Voer de volgende opdracht uit:

  (Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MP
  

• Voeg het https:// te gebruiken voorvoegsel toe aan de /mp parameter.

Voorbeeld van wanneer u de URL van de Cloud Management Gateway gebruikt: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

/NoCRLCheck

Hiermee wordt opgegeven dat een client de lijst met ingetrokken certificaten (CRL) niet mag controleren wanneer deze via HTTPS communiceert met een PKI-certificaat. Als u deze parameter niet opgeeft, wordt de CRL gecontroleerd voordat er een HTTPS-verbinding tot stand wordt gebracht. Zie Intrekking van PKI-certificaten plannen voor meer informatie over CRL-controle voor clients.

Voorbeeld: CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

Deze parameter voorkomt dat CCMSetup wordt uitgevoerd als een service. Dit gebeurt standaard wel. Wanneer CCMSetup als een service wordt uitgevoerd, wordt het uitgevoerd binnen de context van het lokale systeemaccount van de computer. Dit account heeft mogelijk onvoldoende rechten voor toegang tot de vereiste netwerkbronnen voor de installatie. Met /noservicewordt CCMSetup.exe uitgevoerd binnen de context van het gebruikersaccount waarmee u de installatie start.

Voorbeeld: ccmsetup.exe /noservice

/regtoken

Gebruik deze parameter om een bulkregistratietoken toe te voegen. Een op internet gebaseerd apparaat gebruikt dit token in het registratieproces via een Cloud Management Gateway (CMG). Zie Token-based authentication for CMG (Verificatie met tokens) voor meer informatie.

Wanneer u deze parameter gebruikt, moet u ook de volgende parameters en eigenschappen opnemen:

• /mp
• CCMHOSTNAME
• SMSSITECODE
• SMSMP

De volgende voorbeeldopdrachtregel bevat de andere vereiste instellingsparameters en eigenschappen:

ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72186325152220500 CCMHOSTNAME=CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72186325152220500 SMSSITECODE=ABC SMSMP=https://mp1.contoso.com /regtoken:eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6Ik9Tbzh2Tmd5VldRUjlDYVh5T2lacHFlMDlXNCJ9.eyJTQ0NNVG9rZW5DYXRlZ29yeSI6IlN7Q01QcmVBdXRoVG9rZW4iLCJBdXRob3JpdHkiOiJTQ0NNIiwiTGljZW5zZSI6IlNDQ00iLCJUeXBlIjoiQnVsa1JlZ2lzdHJhdGlvbiIsIlRlbmFudElkIjoiQ0RDQzVFOTEtMEFERi00QTI0LTgyRDAtMTk2NjY3RjFDMDgxIiwiVW5pcXVlSWQiOiJkYjU5MWUzMy1wNmZkLTRjNWItODJmMy1iZjY3M2U1YmQwYTIiLCJpc3MiOiJ1cm46c2NjbTpvYXV0aDI6Y2RjYzVlOTEtMGFkZi00YTI0LTgyZDAtMTk2NjY3ZjFjMDgxIiwiYXVkIjoidXJuOnNjY206c2VydmljZSIsImV4cCI6MTU4MDQxNbUwNSwibmJmIjoxNTgwMTU2MzA1fQ.ZUJkxCX6lxHUZhMH_WhYXFm_tbXenEdpgnbIqI1h8hYIJw7xDk3wv625SCfNfsqxhAwRwJByfkXdVGgIpAcFshzArXUVPPvmiUGaxlbB83etUTQjrLIk-gvQQZiE5NSgJ63LCp5KtqFCZe8vlZxnOloErFIrebjFikxqAgwOO4i5ukJdl3KQ07YPRhwpuXmwxRf1vsiawXBvTMhy40SOeZ3mAyCRypQpQNa7NM3adCBwUtYKwHqiX3r1jQU0y57LvU_brBfLUL6JUpk3ri-LSpwPFarRXzZPJUu4-mQFIgrMmKCYbFk3AaEvvrJienfWSvFYLpIYA7lg-6EVYRcCAA

/retry

Als CCMSetup.exe de installatiebestanden niet kunnen downloaden, gebruikt u deze parameter om het interval voor het opnieuw proberen in minuten op te geven. CCMSetup blijft het opnieuw proberen tot de limiet is bereikt die in de /downloadtimeout parameter is opgegeven.

Voorbeeld: ccmsetup.exe /retry:20

/service

Hiermee wordt opgegeven dat CCMSetup moet worden uitgevoerd als een service die gebruikmaakt van het lokale systeemaccount.

Voorbeeld: ccmsetup.exe /service

/skipprereq

Deze parameter geeft aan dat CCMSetup.exe de opgegeven vereiste niet installeert. U kunt meer dan één waarde invoeren. Gebruik een puntkomma (;) om de waarden van elkaar te scheiden.

Voorbeelden:

• CCMSetup.exe /skipprereq:filename.exe

• CCMSetup.exe /skipprereq:filename1.exe;filename2.exe

Zie Clientvereisten voor Windows voor meer informatie over clientvereisten.

/source

Hiermee geeft u de locatie voor het downloaden van het bestand op. Gebruik een lokaal of UNC-pad. Het apparaat downloadt bestanden via het SMB-protocol (Server Message Block). Het Windows-gebruikersaccount voor clientinstallatie kan alleen worden gebruikt /sourceals leesmachtigingen voor de locatie nodig.

Zie Boundary groups - client installation (Grensgroepen - clientinstallatie) voor meer informatie over de manier waarop ccmsetup inhoud downloadt. Dit artikel bevat ook informatie over het gedrag van ccmsetup als u zowel parameters /mp als /source parameters gebruikt.

Voorbeeld: ccmsetup.exe /source:"\\server\share"

/uninstall

Gebruik deze parameter om de Configuration Manager-client te verwijderen. Zie De client verwijderen voor meer informatie.

Voorbeeld: ccmsetup.exe /uninstall

/UsePKICert

Geef deze parameter op zodat de client een PKI-clientverificatiecertificaat moet gebruiken. Als u deze parameter niet opneemt of als de client geen geldig certificaat kan vinden, worden alle HTTPS-beheerpunten uitgefilterd, inclusief Cloud Management Gateways (CMG). De client gebruikt een HTTP-verbinding met een zelfondertekend certificaat.

Voorbeeld: CCMSetup.exe /UsePKICert

Als een apparaat gebruikmaakt van Microsoft Entra ID voor clientverificatie en ook een op PKI gebaseerd certificaat voor clientverificatie heeft, kan de client, als je deze parameter opneemt, geen onboardinggegevens van Microsoft Entra ophalen van een Cloud Management Gateway (CMG). Voor een client die gebruikmaakt van Microsoft Entra-verificatie geeft u deze parameter niet op, maar neemt u de eigenschappen AADRESOURCEURI en AADCLIENTAPPID op.

/IgnoreSkipUpgrade

Geef deze parameter op om een uitgesloten client handmatig bij te werken. Zie Clients uitsluiten van een upgrade voor meer informatie.

CCMSetup.exe retourcodes

De opdracht CCMSetup.exe biedt de volgende retourcodes. Om problemen op te lossen, bekijk %WinDir%\ccmsetup\Logs\ccmsetup.log op de client voor context en aanvullende details over retourcodes.

Ccmsetup.msi eigenschappen

De volgende eigenschappen kunnen het installatiegedrag van ccmsetup.msi wijzigen.

CCMSETUPCMD

Gebruik deze ccmsetup. MSI-eigenschap om aanvullende opdrachtregelparameters en eigenschappen door te geven aan CCMPupt. exe. Neem andere parameters en eigenschappen op tussen aanhalingstekens ("). Gebruik deze eigenschap wanneer u de Configuration Manager client opstart met de Intune MDM-installatiemethode.

Voorbeeld: ccmsetup.msi CCMSETUPCMD="/mp:https://mp.contoso.com CCMHOSTNAME=mp.contoso.com"

Client.msi eigenschappen

Met de volgende eigenschappen kan het installatiegedrag van client.msi, dat ccmsetup.exe installeert, worden gewijzigd.

AADCLIENTAPPID

Hiermee geeft u de id van de Microsoft Entra-client-app op. U maakt of importeert de client-app wanneer u Azure-services configureert voor Cloud Management. Een Azure-beheerder kan de waarde voor deze eigenschap ophalen uit de Azure Portal. Zie Toepassings-id ophalen voor meer informatie. Voor de AADCLIENTAPPID eigenschap is deze toepassings-id voor het systeemeigen toepassingstype.

Voorbeeld: ccmsetup.exe AADCLIENTAPPID=aa28e7f1-b88a-43cd-a2e3-f88b257c863b

AADRESOURCEURI

Hiermee geeft u de app-id van de Microsoft Entra-server op. U maakt of importeert de server-app wanneer u Azure-services configureert voor cloudbeheer. Wanneer u de server-app maakt in het venster Servertoepassing maken, is deze eigenschap de App-id URI.

Een Azure-beheerder kan de waarde voor deze eigenschap ophalen uit de Azure Portal. Zoek in Microsoft Entra ID de server-app onder App-registraties. Zoek naar het toepassingstype Web-app/API. Open de app, selecteer Instellingen en selecteer vervolgens Eigenschappen. Gebruik de waarde voor de app-id URI voor deze AADRESOURCEURI clientinstallatie-eigenschap.

Voorbeeld: ccmsetup.exe AADRESOURCEURI=https://contososerver

AADTENANTID

Hiermee geeft u de tenant-id van Microsoft Entra op. Configuration Manager koppelt deze tenant wanneer u Azure-services configureert voor cloudbeheer. Voer de volgende stappen uit om de waarde voor deze eigenschap vast te stellen:

• Open een opdrachtprompt op een apparaat met Windows 10 of hoger dat is gekoppeld aan dezelfde Microsoft Entra-tenant.

• Voer de volgende opdracht uit: dsregcmd.exe /status

• Zoek in de sectie Apparaatstatus de waarde voor TenantId . Bijvoorbeeld TenantId : aaaabbbb-0000-cccc-1111-dddd2222eeee

  Opmerking

  Een Azure-beheerder kan deze waarde ook verkrijgen in de Azure Portal. Zie Tenant-id ophalen voor meer informatie.

Voorbeeld: ccmsetup.exe AADTENANTID=aaaabbbb-0000-cccc-1111-dddd2222eeee

CCMADMINS

Hiermee geeft u een of meer Windows-gebruikersaccounts of -groepen op die toegang krijgen tot clientinstellingen en -beleid. Deze eigenschap is handig als u geen lokale beheerdersreferenties hebt op de clientcomputer. Een lijst met accounts opgeven die worden gescheiden door puntkomma's (;).

Voorbeeld: CCMSetup.exe CCMADMINS="domain\account1;domain\group1"

CCMALLOWSILENTREBOOT

Laat de computer zo nodig op de achtergrond opnieuw opstarten na de installatie van de client.

Voorbeeld: CCMSetup.exe CCMALLOWSILENTREBOOT

CCMALWAYSINF

Als u wilt opgeven dat de client altijd wordt uitgevoerd op internet en nooit verbinding met het intranet maakt, stelt u deze eigenschapswaarde in op 1. Het verbindingstype van de client is Altijd internet.

Gebruik deze eigenschap met CCMHOSTNAME om de FQDN van het internetbeheerpunt op te geven. Gebruik het bestand ook met de CCMSetup-parameter UsePKICert en de eigenschap SMSSITECODE .

Zie voor meer informatie over clientbeheer via internet Overwegingen voor clientcommunicatie via internet of een niet-vertrouwd forest.

Voorbeeld: CCMSetup.exe /UsePKICert CCMALWAYSINF=1 CCMHOSTNAME=SERVER3.CONTOSO.COM SMSSITECODE=ABC

CCMCERTISSUERS

Gebruik deze eigenschap om de lijst met certificaatuitgevers op te geven. Deze lijst bevat certificaatinformatie voor de vertrouwde basiscertificeringsinstanties (CA) die door de Configuration Manager-site worden vertrouwd.

Deze waarde is een hoofdlettergevoelige overeenkomst voor onderwerpkenmerken in het certificaat van de basiscertificeringsinstantie. Scheid kenmerken met een komma (,) of een puntkomma ().; Geef meerdere certificaten van basiscertificeringsinstanties op met behulp van een scheidingsbalk (|).

Voorbeeld: CCMCERTISSUERS="CN=Contoso Root CA; OU=Servers; O=Contoso, Ltd; C=US | CN=Litware Corporate Root CA; O=Litware, Inc."

Zie Planning for PKI client certificate selection (PKI-clientcertificaatselectie) voor meer informatie over de lijst met certificaatuitgevers en hoe clients deze gebruiken tijdens het certificaatselectieproces.

CCMCERTNAMECHECK

Vanaf versie 2207 kan deze eigenschap worden gebruikt om het controleren van de onderwerpnaam voor het certificaat over te slaan. CCMCERTNAMECHECK=0 Het controleren van de onderwerpsnaam van het certificaat wordt overgeslagen.

CCMCERTSEL

Als de client meer dan één certificaat voor HTTPS-communicatie heeft, specificeert deze eigenschap de criteria voor het selecteren van een geldig clientverificatiecertificaat.

Gebruik de volgende trefwoorden om de onderwerpnaam of alternatieve naam van het certificaat te zoeken:

• Subject: Een exacte overeenkomst zoeken
• SubjectStr: een gedeeltelijke overeenkomst zoeken

Voorbeelden:

• CCMCERTSEL="Subject:computer1.contoso.com": zoek naar een certificaat dat exact overeenkomt met de computernaam computer1.contoso.com in de onderwerpnaam of de alternatieve naam van het onderwerp.

• CCMCERTSEL="SubjectStr:contoso.com": zoek naar een certificaat met contoso.com de onderwerpnaam of de alternatieve naam voor het onderwerp.

Gebruik het SubjectAttr trefwoord om te zoeken naar de kenmerken Object Identifier (OID) of DN-namen in de onderwerpnaam of alternatieve naam van het onderwerp.

Voorbeelden:

• CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": zoek naar het kenmerk van de organisatie-eenheid, uitgedrukt als een object-id en met een naam Computers.

• CCMCERTSEL="SubjectAttr:OU = Computers": zoek naar het kenmerk van de organisatie-eenheid, uitgedrukt als een DN-naam, en met een naam Computers.

Zie Ondersteunde kenmerkwaarden voor PKI-certificaatselectiecriteria voor de volledige lijst met kenmerken die u kunt gebruiken voor certificaatselectie.

Als er meer dan één certificaat overeenkomt met de zoekopdracht en u stelt CCMFIRSTCERT dit in 1, selecteert het clientinstallatieprogramma het certificaat met de langste geldigheidsperiode.

CCMCERTSTORE

Als het client-installatieprogramma geen geldig certificaat kan vinden in het standaard persoonlijke certificaatarchief van de computer, gebruikt u deze eigenschap om een alternatieve naam voor het certificaatarchief op te geven.

Voorbeeld: CCMSetup.exe /UsePKICert CCMCERTSTORE="ConfigMgr"

CCMDEBUGLOGGING

Met deze eigenschap kan foutopsporing worden geregistreerd tijdens de installatie van de client. Deze eigenschap zorgt ervoor dat de client informatie op laag niveau registreert voor probleemoplossing. Vermijd het gebruik van deze eigenschap in productiesites. Er kan sprake zijn van overmatige logging, waardoor het lastig wordt om relevante informatie te vinden in de logbestanden. Schakel ook .CCMENABLELOGGING

Ondersteunde waarden:

• 0: Logboekregistratie voor foutopsporing uitschakelen (standaard)
• 1: Logboekregistratie voor foutopsporing inschakelen

Voorbeeld: CCMSetup.exe CCMDEBUGLOGGING=1

Zie Info over logbestanden voor meer informatie.

CCMENABLELOGGING

In Configuration Manager is logboekregistratie standaard ingeschakeld.

Ondersteunde waarden:

• TRUE: Logboekregistratie inschakelen (standaard)
• FALSE: logboekregistratie uitschakelen

Voorbeeld: CCMSetup.exe CCMENABLELOGGING=TRUE

Zie Info over logbestanden voor meer informatie.

CCMEVALINTERVAL

De frequentie (in minuten) waarmee de Client Health Evaluation Tool (ccmeval.exe) wordt uitgevoerd. Geef een geheel getal op van 1 tot 1440. CCMEVAL wordt standaard eenmaal per dag uitgevoerd (1440 minuten).

Voorbeeld: CCMSetup.exe CCMEVALINTERVAL=1440

Zie Cliënten bewaken voor meer informatie over het evalueren van de clientstatus.

CCMEVALHOUR

Het uur gedurende de dag waarop de Client Health Evaluation Tool (ccmeval.exe) wordt uitgevoerd. Geef een geheel getal op tussen 0 (middernacht) en 23 (23:00 uur). De CCMEVAL wordt standaard om middernacht uitgevoerd.

Zie Cliënten bewaken voor meer informatie over het evalueren van de clientstatus.

CCMFIRSTCERT

Als u deze eigenschap instelt op 1, selecteert de client het PKI-certificaat met de langste geldigheidsduur.

Voorbeeld: CCMSetup.exe /UsePKICert CCMFIRSTCERT=1

CCMHOSTNAME

Als de client via internet wordt beheerd, specificeert deze eigenschap de FQDN van het internetbeheerpunt.

Geef deze optie niet op met de installatie-eigenschap .SMSSITECODE=AUTO Internetclients rechtstreeks toewijzen aan een internetsite.

Voorbeeld: CCMSetup.exe /UsePKICert CCMHOSTNAME="SMSMP01.corp.contoso.com"

Met deze eigenschap kan het adres van een CMG (Cloud Management Gateway) worden opgegeven. Voer de volgende stappen uit om de waarde voor deze eigenschap vast te stellen:

• Maak een CMG. Zie Een CMG instellen voor meer informatie.

• Open op een actieve client een Windows PowerShell-opdrachtprompt als beheerder.

• Voer de volgende opdracht uit:

  (Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MP
  

• Gebruik de geretourneerde waarde zoals deze zich met de CCMHOSTNAME eigenschap bevindt.

Bijvoorbeeld:ccmsetup.exe CCMHOSTNAME=CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

CCMHTTPPORT

Hiermee geeft u de poort op die de client moet gebruiken wanneer deze via HTTP communiceert met systeemservers van de site. Deze waarde is 80standaard .

Voorbeeld: CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORT

Hiermee geeft u de poort op die de client moet gebruiken wanneer deze via HTTPS communiceert met de systeemservers van de site. Deze waarde is 443standaard .

Voorbeeld: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

Gebruik deze eigenschap om de map in te stellen voor het installeren van de Configuration Manager-clientbestanden. Standaard gebruikt %WinDir%\CCMhet .

Voorbeeld: CCMSetup.exe CCMINSTALLDIR="C:\ConfigMgr"

CCMLOGLEVEL

Gebruik deze eigenschap om het detailniveau op te geven dat naar logboekbestanden van Configuration Manager moet worden geschreven.

Ondersteunde waarden:

• 0: Uitgebreid
• 1: Standaard
• 2: Waarschuwingen en fouten
• 3: Alleen fouten

Voorbeeld: CCMSetup.exe CCMLOGLEVEL=0

Zie Info over logbestanden voor meer informatie.

CCMLOGMAXHISTORY

Wanneer een logboekbestand van Configuration Manager de maximale grootte bereikt, wordt dit door de client hernoemd als een back-up en wordt een nieuw logboekbestand gemaakt. Met deze eigenschap geeft u op hoeveel vorige versies van het logboekbestand u wilt bewaren. De standaardwaarde is 1. Als u de waarde instelt op 0, houdt de client geen logboekgeschiedenis bij.

Voorbeeld: CCMSetup.exe CCMLOGMAXHISTORY=5

Zie Info over logbestanden voor meer informatie.

CCMLOGMAXSIZE

Deze eigenschap geeft de maximale grootte van het logboekbestand in bytes aan. Wanneer een logboek de opgegeven grootte heeft, wordt de naam ervan gewijzigd in een overzichtsbestand en wordt er een nieuw bestand gemaakt. De standaardgrootte is 250.000 bytes en de minimumgrootte is 10.000 bytes.

Voorbeeld: CCMSetup.exe CCMLOGMAXSIZE=300000 (300.000 bytes)

DISABLESITEOPT

Stel deze eigenschap in om TRUE te voorkomen dat beheerders de toegewezen site wijzigen in het Configuratiescherm van Configuration Manager.

Voorbeeld: CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

Als deze eigenschap is ingesteld op TRUE, kunnen gebruikers met beheerdersrechten de instellingen voor mappen in de clientcache niet wijzigen in het Configuratiescherm van Configuration Manager.

Voorbeeld: CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIX

Geef een DNS-domein op voor clients om beheerpunten op te sporen die u publiceert in DNS. Wanneer de klant een beheerpunt vindt, wordt de klant geïnformeerd over andere beheerpunten in de hiërarchie. Dit gedrag betekent dat het beheerpunt dat de client vindt in DNS een persoon in de hiërarchie kan zijn.

Zie Servicelocatie en hoe clients hun toegewezen beheerpunt bepalen voor meer informatie over DNS-publicatie als servicelocatiemethode voor Configuration Manager-clients.

Voorbeeld: CCMSetup.exe SMSSITECODE=ABC DNSSUFFIX=contoso.com

FSP

Hiermee geeft u het terugvalstatuspunt op waarmee statusberichten worden ontvangen en verwerkt die worden verzonden door Configuration Manager-clients.

Zie Bepalen of u een terugvalstatuspunt nodig hebt voor meer informatie.

Voorbeeld: CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

Als u deze eigenschap instelt op TRUE, wordt de minimaal vereiste versie van Microsoft Application Virtualization (App-V) niet gecontroleerd door het clientinstallatieprogramma.

Voorbeeld: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

MANAGEDINSTALLER

Als u deze eigenschap zo instelt, 1 worden ccmsetup.exe en client.msi ingesteld als beheerde installatieprogramma's. Zie Automatisch apps toestaan die zijn geïmplementeerd door een beheerd installatieprogramma met Windows Defender-toepassingsbeheer voor meer informatie.

Voorbeeld: CCMSetup.exe MANAGEDINSTALLER=1

NOTIFYONLY

Wanneer u deze eigenschap inschakelt, rapporteert de client de status, maar worden gevonden problemen niet verholpen.

Voorbeeld: CCMSetup.exe NOTIFYONLY=TRUE

Zie De clientstatus configureren voor meer informatie.

PROVISIONTS

Gebruik deze eigenschap om een takenreeks te starten op een client nadat deze op de site is geregistreerd.

U richt bijvoorbeeld een nieuw Windows-apparaat in met Windows Autopilot, schrijft het automatisch in bij Microsoft Intune en installeert vervolgens de Configuration Manager-client voor co-beheer. Als u deze nieuwe optie opgeeft, wordt op de nieuw ingerichte client een taakreeks uitgevoerd. Dit proces biedt u extra flexibiliteit bij het installeren van toepassingen en software-updates of het configureren van instellingen.

Gebruik de volgende procedure:

1. Maak een implementatiereeks voor andere programma's dan het besturingssysteem om apps te installeren, software-updates te installeren en instellingen te configureren.

2. Implementeer deze taken reeks naar de nieuwe ingebouwde verzameling, Alle inrichtingsapparaten. Noteer bijvoorbeeld de implementatie-id PRI20001van de takenreeks.

   Tip

   Het doel van de implementatie kan beschikbaar of vereist zijn. Aangezien u de implementatie-id opgeeft als de eigenschapswaarde, doet het doel er niet toe.

3. Installeer de Configuration Manager client op een apparaat met ccmsetup.msien gebruik de volgende eigenschap: PROVISIONTS=PRI20001. Stel de waarde van deze eigenschap in als de implementatie-id van de takenreeks.

   • Als u de client installeert vanuit Intune tijdens de inschrijving voor co-beheer, raadpleegt u Internetapparaten voorbereiden voor co-beheer.

     Opmerking

     Voor deze methode zijn mogelijk aanvullende vereisten vereist. Bijvoorbeeld door de site in te schrijven bij Microsoft Entra ID of door een cloudbeheergateway met inhoud te maken.

     Gebruik, ongeacht de methode, deze eigenschap alleen met ccmsetup.msi.

Nadat de client is geïnstalleerd en zich op de juiste manier bij de site registreert, wordt de reeks taken gestart waarnaar wordt verwezen. Als de clientregistratie mislukt, wordt de takenreeks niet gestart.

RESETKEYINFORMATION

Als een client de verkeerde vertrouwde basissleutel voor Configuration Manager heeft, kan deze geen contact opnemen met een vertrouwd beheerpunt om de nieuwe vertrouwde basissleutel te ontvangen. Gebruik deze eigenschap om de oude vertrouwde basissleutel te verwijderen. Deze situatie kan optreden wanneer u een klant van de ene sitehiërarchie naar de andere verplaatst. Deze eigenschap is van toepassing op clients die gebruikmaken van HTTP en HTTPS-clientcommunicatie. Zie Planning voor de vertrouwde basissleutel voor meer informatie.

Voorbeeld: CCMSetup.exe RESETKEYINFORMATION=TRUE

SITEREASSIGN

Hiermee wordt automatische hertoewijzing van sites voor clientupgrades ingeschakeld bij gebruik met SMSSITECODE=AUTO.

Voorbeeld: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE

SMSCACHEDIR

Hiermee geeft u de locatie op van de map met de clientcache op de clientcomputer. De standaardlocatie voor de cache is %WinDir%\ccmcache.

Voorbeeld: CCMSetup.exe SMSCACHEDIR="C:\Temp"

Gebruik deze eigenschap in combinatie met de SMSCACHEFLAGS eigenschap om de locatie van de map in de clientcache te beheren. Als u bijvoorbeeld de map met de clientcache op het grootste beschikbare clientstation wilt installeren, gaat u als volgt te werk: CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE

SMSCACHEFLAGS

Gebruik deze eigenschap om verdere installatiedetails op te geven voor de clientcachemap. U kunt eigenschappen afzonderlijk gebruiken SMSCACHEFLAGS of in combinatie gescheiden door puntkomma's (;).

Als u deze eigenschap niet opneemt:

• De client installeert de cachemap op basis van de SMSCACHEDIR eigenschap.
• De map wordt niet gecomprimeerd
• De client gebruikt de SMSCACHESIZE eigenschap als de groottelimiet (in MB) van de cache

Wanneer u een upgrade uitvoert op een bestaande client, negeert het clientinstallatieprogramma deze eigenschap.

Waarden voor de SMSCACHEFLAGS eigenschap

• PERCENTDISKSPACE: stel de cachegrootte in als een percentage van de totale schijfruimte. Als u deze eigenschap opgeeft, moet u deze ook instellen SMSCACHESIZE op een percentage.

• PERCENTFREEDISKSPACE: stel de cachegrootte in als een percentage van de beschikbare schijfruimte. Als u deze eigenschap opgeeft, moet u deze ook instellen SMSCACHESIZE als een percentage. De schijf heeft bijvoorbeeld 10 MB beschikbaar en u geeft SMSCACHESIZE=50. Het client-installatieprogramma stelt de cachegrootte in op 5 MB. U kunt deze eigenschap niet gebruiken met de PERCENTDISKSPACE eigenschap.

• MAXDRIVE: Installeer de cache op de grootst beschikbare schijf. Als u een pad met de SMSCACHEDIR eigenschap opgeeft, negeert het clientinstallatieprogramma deze waarde.

• MAXDRIVESPACE: Installeer de cache op het schijfstation met de meeste vrije ruimte. Als u een pad met de SMSCACHEDIR eigenschap opgeeft, negeert het clientinstallatieprogramma deze waarde.

• NTFSONLY: Installeer de cache alleen op een met NTFS geformatteerd schijfstation. Als u een pad met de SMSCACHEDIR eigenschap opgeeft, negeert het clientinstallatieprogramma deze waarde.

• COMPRESS: sla de cache op in gecomprimeerde vorm.

• FAILIFNOSPACE: als er onvoldoende ruimte is om de cache te installeren, verwijder je de Configuration Manager-client.

Voorbeeld: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

Wanneer u een upgrade uitvoert voor een bestaande client, wordt deze instelling genegeerd. De client negeert ook de cachegrootte wanneer software-updates worden gedownload.

Voorbeeld: CCMSetup.exe SMSCACHESIZE=100

SMSCONFIGSOURCE

Gebruik deze eigenschap om de locatie en volgorde op te geven die door het clientinstallatieprogramma worden gecontroleerd voor configuratie-instellingen. Het is een tekenreeks van een of meer tekens die elk een specifieke configuratiebron definiëren:

• R: controleer de configuratie-instellingen in het register.

  Zie Eigenschappen van clientinstallatie inrichten voor meer informatie.

• P: controleer op configuratie-instellingen in de installatie-eigenschappen vanaf de opdrachtregel.

• M: controleer de bestaande instellingen wanneer je een upgrade uitvoert voor een oudere client.

• U: voer een upgrade uit van de geïnstalleerde client naar een nieuwere versie en gebruik de toegewezen sitecode.

Het clientinstallatieprogramma gebruikt PUstandaard . Eerst worden de installatie-eigenschappen (P) gecontroleerd en vervolgens de bestaande instellingen (U).

Voorbeeld: CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMP

Hiermee wordt een initieel beheerpunt opgegeven dat de Configuration Manager-client moet gebruiken.

Voorbeelden:

• CCMSetup.exe SMSMP=smsmp01.contoso.com

• CCMSetup.exe SMSMP=https://smsmp01.contoso.com

SMSMPLIST

Hiermee wordt een lijst met beheerpunten opgegeven die de Configuration Manager-client moet gebruiken. Gebruik een puntkomma (;) als scheidingsteken wanneer u meerdere beheerpunten opgeeft.

Voorbeelden:

• CCMSetup.exe SMSMPLIST=https://smsmp01.contoso.com;https://smsmp02.contoso.com;smsmp03.contoso.com

• CCMSetup.exe SMSMPLIST=https://smsmp01.contoso.com;smsmp02.contoso.com;smsmp03.contoso.com

SMSPUBLICROOTKEY

Als de client de vertrouwde basissleutel van Configuration Manager niet kan ophalen uit Active Directory Domain Services, gebruikt u deze eigenschap om de sleutel op te geven. Deze eigenschap is van toepassing op clients die gebruikmaken van HTTP- en HTTPS-communicatie. Zie Planning voor de vertrouwde basissleutel voor meer informatie.

Voorbeeld: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

SMSROOTKEYPATH

Gebruik deze eigenschap om de vertrouwde basissleutel van Configuration Manager opnieuw te installeren. Hiermee geeft u het volledige pad en de naam op van een bestand dat de vertrouwde basissleutel bevat. Deze eigenschap is van toepassing op clients die gebruikmaken van HTTP en HTTPS-clientcommunicatie. Zie Planning voor de vertrouwde basissleutel voor meer informatie.

Voorbeeld: CCMSetup.exe SMSROOTKEYPATH=C:\folder\trk

SMSSIGNCERT

Hiermee geeft u het volledige pad en de naam op van het geëxporteerde zelfondertekende certificaat op de siteserver. Dit certificaat wordt door de server opgeslagen in het SMS-certificaatarchief . Het heeft de onderwerpnaam Site Server en de beschrijvende naam Site Server Signing Certificate.

Exporteer het certificaat zonder de persoonlijke sleutel, sla het bestand veilig op en open het alleen via een beveiligd kanaal.

Voorbeeld: CCMSetup.exe /UsePKICert SMSSIGNCERT=C:\folder\smssign.cer

SMSSITECODE

Met deze eigenschap wordt een Configuration Manager-site opgegeven waaraan u de client toewijst. Deze waarde kan een sitecode van drie tekens zijn of het woord AUTO. Als u deze eigenschap wel of niet opgeeftAUTO, probeert de client de sitetoewijzing vast te stellen vanuit Active Directory Domain Services of vanuit een opgegeven beheerpunt. Als u clientupgrades wilt inschakelen AUTO , moet u ook SITEREASSIGN=TRUE instellen.

Voorbeeld: CCMSetup.exe SMSSITECODE=XZY

UPGRADETOLATEST

Met deze eigenschap wordt CCMSetup gedwongen een locatieaanvraag te verzenden naar het beheerpunt om de meest recente versie van de Configuration Manager-clientinstallatiebron op te halen. Er zijn verschillende scenario's waarbij deze eigenschap bijzonder handig is:

• Pre-productie klanten. Een nieuw geïnstalleerde client gebruikt de productiebasislijn omdat de pre-productieverzameling pas kan worden geëvalueerd als de client is geïnstalleerd. In dit scenario wordt, nadat de client is geïnstalleerd en het beleid is geëvalueerd, later een upgrade uitgevoerd naar de pre-productieclientversie. Gebruik deze eigenschap zodat de nieuwste versie van de client direct wordt geïnstalleerd.

  Dit scenario omvat ook het gebruik van Windows Autopilot in co-beheer. Gebruik deze eigenschap om ervoor te zorgen dat het nieuw ingerichte Windows Autopilot-apparaat meteen gebruikmaakt van de pre-productieclientversie.

• Trek distributiepunten op. Sta pull-distributiepunten toe om de nieuwste clientversie te installeren, zelfs als deze zich niet in de pre-productieverzameling bevindt. Deze actie zorgt ervoor dat de clientversie op het pull-distributiepunt hetzelfde is als de binaire bestanden van het distributiepunt. Als deze versies niet hetzelfde zijn, kan dit problemen veroorzaken.

Kenmerkwaarden voor certificaatselectiecriteria

Configuration Manager ondersteunt de volgende kenmerkwaarden voor de selectiecriteria voor PKI-certificaten:

Installatie van client push

Als u de installatiemethode voor pushen op client gebruikt, gebruikt u de volgende opties op het tabblad Client van de installatie-eigenschappen voor pushen op client in de Configuration Manager-console:

• Een van de Client.msi eigenschappen

• De volgende subset van CCMSetup.exe opdrachtregelparameters zijn toegestaan voor pushen op de client:

  • /AllowMetered (vanaf versie 2103)

  • /AlwaysExcludeUpgrade

  • /BITSPriority

  • /downloadtimeout

  • /ExcludeFeatures

  • /forcereboot

  • /logon

  • /skipprereq

  • /UsePKICert