Dela via

Om parametrar och egenskaper för klientinstallationen i Configuration Manager

  • Artikel

Gäller för: Konfigurationshanteraren (current branch)

Använd kommandot CCMSetup.exe för att installera Configuration Manager-klienten. Om du anger klientinstallationens parametrar på kommandoraden ändrar de installationsbeteendet. Om du anger klientinstallationens egenskaper på kommandoraden ändrar de den första konfigurationen för den installerade klientagenten.

Om CCMSetup.exe

Kommandot CCMSetup.exe laddar ned nödvändiga filer för att installera klienten från en hanteringsplats eller en källplats. Filerna kan innehålla:

  • Windows Installer-paketet client.msi som installerar klientprogramvaran

  • Klientkrav

  • Uppdateringar och korrigeringar för Configuration Manager-klienten

Obs!

Du kan inte installera client.msi direkt.

För att anpassa installationen tillhandahåller CCMSetup.exe parametrar för kommandoraden. Parametrar är prefix med ett snedstreck (/) och består vanligtvis av gemener. Du kan ange värdet för en parameter när det behövs med ett kolon (:) omedelbart följt av värdet. Mer information finns i Kommandoradsparametrar för CCMSetup.exe.

Du kan även ange egenskaper på kommandoraden CCMSetup.exe för att ändra beteendet för client.msi. Egenskaper efter konvention består av versaler. Du anger ett värde för en egenskap med ett likhetstecken (=) omedelbart följt av värdet. Mer information finns i Egenskaper för client.msi.

Viktigt

Ange parametrar för CCMSetup innan du anger egenskaper för client.msi.

CCMSetup.exe samt stödfilerna finns på platsservern i mappen Klient i installationsmappen för Configuration Manager. Configuration Manager delar den här mappen till nätverket via webbplatsresursen. Till exempel \\SiteServer\SMS_ABC\Client.

Kommandot CCMSetup.exe använder följande format i kommandotolken:

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

Till exempel:

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

Det här exemplet gör följande:

  • Anger hanteringsplatsen SMSMP01 för att begära en lista över distributionsplatser för att ladda ned klientinstallationsfilerna.

  • Anger att installationen ska stoppas om det redan finns en version av klienten på datorn.

  • Instruerar client.msi att tilldela klienten till platskoden S01.

  • Instruerar client.msi att använda återställningsstatuspunkten SMSFP01.

Tips

Om ett parametervärde innehåller blanksteg omger du det med citattecken.

Om du utökar Active Directory-schemat för Configuration Manager publicerar platsen flera klientinstallationsegenskaper i Active Directory Domain Services. Configuration Manager-klienten läser automatiskt dessa egenskaper. Mer information finns i Om klientinstallationsegenskaper som publicerats till Active Directory Domain Services

Kommandoradsparametrar för CCMSetup.exe

/?

Visar tillgängliga kommandoradsparametrar för ccmsetup.exe.

Exempel: ccmsetup.exe /?

/AllowMetered

Använd den här parametern för att styra klientens beteende i ett nätverk med datapriser. Den här parametern tar inga värden. När du tillåter klientkommunikation i ett nätverk med datapriser för ccmsetup laddas innehållet ned, registreras på webbplatsen och den ursprungliga principen laddas ned. All ytterligare klientkommunikation följer konfigurationen av klientinställningen från den principen. Mer information finns i Om klientinställningar.

Om du installerar om klienten på en befintlig enhet används följande prioritet för att fastställa dess konfiguration:

  1. Befintlig lokal klientprincip
  2. Den sista kommandoraden som lagras i Windows-registret
  3. Parametrar på kommandoraden för ccmsetup

/AlwaysExcludeUpgrade

Den här parametern anger om en klient ska uppgraderas automatiskt när du aktiverar Automatisk klientuppgradering.

Värden som stöds:

  • TRUE: Klienten uppgraderas inte automatiskt
  • FALSE: Klienten uppgraderas automatiskt (standard)

Till exempel:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

Mer information finns i Klient för utökad samverkan.

Obs!

När du använder parametern /AlwaysExcludeUpgrade körs den automatiska uppgraderingen fortfarande. Men när CCMSetup körs för att utföra uppgraderingen kommer den att notera att parametern /AlwaysExcludeUpgrade har angetts och loggar följande rad i ccmsetup.log:

Client is stamped with /alwaysexcludeupgrade. Stop proceeding.

CCMSetup avslutas därmed omedelbart och utför inte uppgraderingen.

/BITSPriority

När enheten hämtar klientinstallationsfiler via en HTTP-anslutning använder du den här parametern för att ange nedladdningsprioriteten. Ange något av följande möjliga värden:

  • FOREGROUND

  • HIGH

  • NORMAL (standard)

  • LOW

Exempel: ccmsetup.exe /BITSPriority:HIGH

/config

Den här parametern anger en textfil som listar egenskaper för klientinstallationen.

  • Om CCMSetup körs som en tjänst placerar du filen i systemmappen CCMSetup: %Windir%\Ccmsetup.

  • Om du anger parametern /noservice placerar du filen i samma mapp som CCMSetup.exe.

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

För att ange rätt filformat använder du filen mobileclienttemplate.tcf i mappen \bin\<platform> i installationskatalogen för Configuration Manager på platsservern. Den här filen innehåller kommentarer om avsnitten och hur du använder dem. Ange klientinstallationsegenskaperna i avsnittet [Client Install] efter följande text: Install=INSTALL=ALL.

Exempel [Client Install] avsnittspost: Install=INSTALL=ALL SMSSITECODE=ABC SMSCACHESIZE=100

/downloadtimeout

Om CCMSetup inte kan hämta klientinstallationsfilerna anger den här parametern den maximala tidsgränsen i minuter. Efter den här tidsgränsen slutar CCMSetup att försöka ladda ned installationsfilerna. Standardvärdet är 1440 minuter (en dag).

Använd parametern /retry för att ange intervallet mellan återförsök.

Exempel: ccmsetup.exe /downloadtimeout:100

/ExcludeFeatures

Den här parametern anger att CCMSetup.exe inte installerar den angivna funktionen.

Exempel: CCMSetup.exe /ExcludeFeatures:ClientUI installerar inte Software Center på klienten.

Obs!

ClientUI är det enda värde som parametern /ExcludeFeatures stöder.

/forceinstall

Ange att CCMSetup.exe avinstallerar alla befintliga klienter och installerar en ny klient.

/forcereboot

Använd den här parametern för att tvinga datorn att starta om vid behov för att slutföra installationen. Om du inte anger den här parametern avslutas CCMSetup när en omstart krävs. Den fortsätter sedan efter nästa manuella omstart.

Exempel: CCMSetup.exe /forcereboot

/logon

Om någon version av klienten redan är installerad anger den här parametern att klientinstallationen ska stoppas.

Exempel: ccmsetup.exe /logon

/mp

Anger en hanteringsplats som klienterna ska använda för att hitta närmaste distributionsplats för klientinstallationsfilerna. Om det inte finns några distributionsplatser, eller om datorerna inte kan ladda ned filerna från distributionsplatserna efter fyra timmar, laddar de ned filerna från den angivna hanteringsplatsen.

Mer information om hur ccmsetup laddar ned innehåll finns i Gränsgrupper – klientinstallation. Artikeln innehåller även information om ccmsetup-beteende som kan inträffa om du använder parametrarna /mp och /source.

Viktigt

Den här parametern anger en första hanteringsplats för datorer för att hitta en nedladdningskälla. Det kan vara vilken hanteringsplats som helst på valfri plats. Den tilldelar inte klienten till den angivna hanteringsplatsen.

Datorer laddar ned filerna via en HTTP- eller HTTPS-anslutning, beroende på platssystemets rollkonfiguration för klientanslutningar. Nedladdningen kan även använda BITS-begränsning om du först konfigurerar det. Om du konfigurerar alla distributionsplatser och hanteringsplatser endast för HTTPS-klientanslutningar kontrollerar du att klientdatorn har ett giltigt klientcertifikat.

Du kan använda kommandoradsparametern /mp för att ange mer än en hanteringsplats. Om datorn inte kan ansluta till den första försöker den med nästa i listan. Avgränsa värdena med semikolon när du anger flera hanteringsplatser.

Om klienten ansluter till en hanteringsplats med HTTPS anger du FQDN, inte datornamnet. Värdet måste matcha ämnet eller det alternativa ämnesnamnet för hanteringsplatsens PKI-certifikat. Även om Configuration Manager har stöd för användning av datornamn i certifikatet för anslutningar på intranätet, rekommenderas du att använder ett FQDN.

Exempel med datornamnet: ccmsetup.exe /mp:SMSMP01

Exempel med FQDN: ccmsetup.exe /mp:smsmp01.contoso.com

Den här parametern kan ange URL:en för en CMG (Cloud Management Gateway). Använd den här URL:en för att installera klienten på en Internetbaserad enhet. Använd följande steg för att hämta värdet för den här parametern:

  • Skapa en CMG. Mer information finns i Konfigurera en CMG.

  • Öppna en Windows PowerShell-kommandotolk som administratör på en aktiv klient.

  • Kör följande kommando:

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

  • Lägg till prefixet https:// som ska användas med parametern /mp.

Exempel på när du använder URL:en för Cloud Management Gateway: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

Viktigt

När du anger URL:en för en CMG (Cloud Management Gateway) för parametern /mp måste den börja med https://.

Obs!

Kommandoradsparametern /mp anger inte den hanteringsplats som används av Configuration Manager-klienten när den har installerats. Om du vill ange den första hanteringsplatsen som används av Configuration Manager-klienten när den har installerats använder du egenskapen SMSMP client.msi. Om du vill ange en lista över hanteringsplatser för Configuration Manager-klienten som ska användas när den har installerats använder du egenskapen SMSMPLIST client.msi.

/NoCRLCheck

Anger att en klient inte bör kontrollera listan över återkallade certifikat när den kommunicerar via HTTPS med ett PKI-certifikat. Om du inte anger den här parametern kontrollerar klienten listan över återkallade certifikat innan den upprättar en HTTPS-anslutning. Mer information om kontroll av CRL för klienter finns i Planera för återkallning av PKI-certifikat.

Exempel: CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

Den här parametern förhindrar att CCMSetup körs som en tjänst, vilket den gör som standard. När CCMSetup körs som en tjänst körs den i kontexten för datorns lokala systemkonto. Det här kontot kanske inte har tillräckliga rättigheter för att få åtkomst till nödvändiga nätverksresurser för installationen. Med /noservice körs CCMSetup.exe i kontexten för det användarkonto som du använder för att starta installationen.

Exempel: ccmsetup.exe /noservice

/regtoken

Använd den här parametern för att ange en massregistreringstoken. En Internetbaserad enhet använder denna token i registreringsprocessen via en CMG (Cloud Management Gateway). Mer information finns i Tokenbaserad autentisering för CMG.

När du använder den här parametern ska du även inkludera följande parametrar och egenskaper:

Följande exempel på kommandoraden innehåller andra obligatoriska konfigurationsparametrar och egenskaper:

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

Tips

Om CCMSetup returnerar fel 0x87d0027e kan du prova att ta bort parametern /mp från kommandoraden.

/retry

Om CCMSetup.exe inte kan hämta installationsfiler använder du den här parametern för att ange återförsöksintervallet i minuter. CCMSetup fortsätter att försöka tills den når gränsen som anges av parametern /downloadtimeout.

Exempel: ccmsetup.exe /retry:20

/service

Anger att CCMSetup ska köras som en tjänst som använder det lokala systemkontot.

Tips

Om du använder ett skript för att köra CCMSetup.exe med parametern /service avslutas CCMSetup.exe när tjänsten startar. Det kanske inte rapporterar installationsinformationen som det ska till skriptet.

Exempel: ccmsetup.exe /service

/skipprereq

Den här parametern anger att CCMSetup.exe inte installerar det angivna kravet. Du kan ange fler än ett värde. Använd semikolon (;) för att avgränsa varje värde.

Exempel:

  • CCMSetup.exe /skipprereq:filename.exe

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

Mer information om klientkrav finns i Klientkrav för Windows.

/source

Anger filhämtningsplatsen. Använd en lokal sökväg eller UNC-sökväg. Enheten laddar ned filer med SMB-protokollet (Server Message Block). Om du vill använda /source behöver Windows-användarkontot för klientinstallationen Läsbehörigheter till platsen.

Mer information om hur ccmsetup laddar ned innehåll finns i Gränsgrupper – klientinstallation. Artikeln innehåller även information om ccmsetup-beteende som kan inträffa om du använder parametrarna /mp och /source.

Tips

Du kan använda parametern /source mer än en gång på en kommandorad för att ange alternativa nedladdningsplatser.

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

/uninstall

Använd den här parametern för att avinstallera Configuration Manager-klienten. Mer information finns i Avinstallera klienten.

Exempel: ccmsetup.exe /uninstall

Obs!

Från och med version 2111 tas även starten av klienten, ccmsetup.msi, bort om den finns när du avinstallerar klienten.

/UsePKICert

Ange den här parametern för att klienten ska använda ett PKI-klientautentiseringscertifikat. Om du inte inkluderar den här parametern, eller om klienten inte kan hitta ett giltigt certifikat, filtrerar den bort alla HTTPS-hanteringsplatser, inklusive CMG (Cloud management gateway). Klienten använder en HTTP-anslutning med ett självsignerat certifikat.

Exempel: CCMSetup.exe /UsePKICert

Om en enhet använder Microsoft Entra-ID för klientautentisering och även har ett PKI-baserat klientautentiseringscertifikat, kan klienten inte få Microsoft Entra registreringsinformation från en molnhanteringsgateway (CMG) om du använder den här parametern. För en klient som använder Microsoft Entra autentisering ska du inte ange den här parametern, utan inkludera egenskaperna AADRESOURCEURI och AADCLIENTAPPID.

Obs!

I vissa scenarier behöver du inte ange den här parametern, men du behöver ändå använda ett klientcertifikat. Exempelvis klientdistribution och programuppdateringsbaserad klientinstallation. Använd den här parametern när du installerar en klient manuellt och använder parametern /mp med en HTTPS-aktiverad hanteringsplats.

Ange även den här parametern när du installerar en klient för enbart internetkommunikation. Använd CCMALWAYSINF=1 tillsammans med egenskaperna för den Internetbaserade hanteringsplatsen (CCMHOSTNAME) och platskoden (SMSSITECODE). Mer information om Internetbaserad klienthantering finns i Att tänka på vid klientkommunikation från Internet eller via en icke-betrodd skog.

/IgnoreSkipUpgrade

Ange den här parametern om du vill uppgradera en exkluderad klient manuellt. Mer information finns i Så här undantar du klienter från uppgradering.

Returkoder för CCMSetup.exe

Kommandot CCMSetup.exe innehåller följande returkoder. Om du vill felsöka granskar du %WinDir%\ccmsetup\Logs\ccmsetup.log på klienten för kontext och ytterligare information om returkoder.

Returkod Betydelse
0 Klart
6 Fel
7 Omstart krävs
8 Konfigurationen körs redan
9 Utvärderingsfel för krav
10 Hashvalideringsfel för konfigurationsmanifestet

Egenskaper för Ccmsetup.msi

Följande egenskaper kan ändra installationsbeteendet för ccmsetup.msi.

CCMSETUPCMD

Använd egenskapen ccmsetup.msi för att skicka ytterligare kommandoradsparametrar och egenskaper till ccmsetup.exe. Inkludera andra parametrar och egenskaper inom citattecken ("). Använd den här egenskapen när du startar Configuration Manager-klienten med Intune MDM-installationsmetoden.

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

Tips

Microsoft Intune begränsar kommandoraden till 1 024 tecken.

Egenskaper för Client.msi

Följande egenskaper kan ändra installationsbeteendet för client.msi, som installeras av ccmsetup.exe.

AADCLIENTAPPID

Anger Microsoft Entra klientappidentifierare. Du skapar eller importerar klientappen när du konfigurerar Azure-tjänster för molnhantering. En Azure-administratör kan hämta värdet för den här egenskapen från Azure Portal. Mer information finns i hämta program-ID. För egenskapen AADCLIENTAPPID är det här program-ID:t till för programtypen Ursprunglig.

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

AADRESOURCEURI

Anger Microsoft Entra serverappidentifierare. Du skapar eller importerar serverappen när du konfigurerar Azure-tjänster för molnhantering. När du skapar serverappen i fönstret Skapa serverprogram är den här egenskapen App-ID-URI.

En Azure-administratör kan hämta värdet för den här egenskapen från Azure Portal. I Microsoft Entra-ID hittar du serverappen under Appregistreringar. Leta efter programtypen webbapp/API. Öppna appen, välj Inställningar och sedan Egenskaper. Använd värdet App ID URI för den här AADRESOURCEURI-klientinstallationsegenskapen.

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

AADTENANTID

Anger Microsoft Entra klientorganisationsidentifierare. Configuration Manager länkar till den här klientorganisationen när du konfigurerar Azure-tjänster för molnhantering. Använd följande steg för att hämta värdet för den här egenskapen:

  • Öppna en kommandotolk på en enhet som kör Windows 10 eller senare och är ansluten till samma Microsoft Entra klientorganisation.

  • Kör följande kommando: dsregcmd.exe /status

  • I avsnittet Enhetstillstånd letar du reda på värdet TenantId. Till exempel TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49a

    Obs!

    En Azure-administratör kan hämta det här värdet från Azure Portal. Mer information finns i hämta klientorganisations-ID.

Exempel: ccmsetup.exe AADTENANTID=607b7853-6f6f-4d5d-b3d4-811c33fdd49a

CCMADMINS

Anger ett eller flera Windows-användarkonton eller -grupper som ska få åtkomst till klientinställningar och principer. Den här egenskapen är användbar om du inte har lokala administrativa autentiseringsuppgifter på klientdatorn. Ange en lista över konton som avgränsas med semikolon (;).

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

CCMALLOWSILENTREBOOT

Om det behövs kan du låta datorn starta om efter klientinstallationen.

Viktigt

När du använder den här egenskapen startas datorn om utan förvarning. Det här beteendet inträffar även om en användare är inloggad i Windows.

Exempel: CCMSetup.exe CCMALLOWSILENTREBOOT

CCMALWAYSINF

Om du vill ange att klienten alltid är Internetbaserad och aldrig ansluter till intranätet anger du det här egenskapsvärdet till 1. Klientens anslutningstyp visar Alltid Internet.

Använd den här egenskapen med CCMHOSTNAME för att ange FQDN för den Internetbaserade hanteringsplatsen. Använd den med CCMSetup-parametern UsePKICert och egenskapen SMSSITECODE.

Mer information om Internetbaserad klienthantering finns i Att tänka på vid klientkommunikation från Internet eller via en icke-betrodd skog.

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

CCMCERTISSUERS

Använd den här egenskapen för att ange listan över certifikatutfärdare. Den här listan innehåller certifikatinformation för de betrodda rotcertifikatutfärdare (CA) som Configuration Manager-platsen litar på.

Det här värdet är en skiftlägeskänslig matchning för ämnesattribut som finns i rotutfärdarcertifikatet. Avgränsa attribut med kommatecken (,) eller semikolon (;). Ange mer än ett rotutfärdarcertifikat med hjälp av en avgränsningslist (|).

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

Tips

Använd värdet för attributet CertificateIssuers i filen mobileclient.tcf för webbplatsen. Den här filen finns i undermappen \bin\<platform> i installationskatalogen för Configuration Manager på platsservern.

Mer information om listan över certifikatutfärdare och hur klienter använder den under urvalsprocessen för certifikat finns i Planera för val av PKI-klientcertifikat.

CCMCERTNAMECHECK

Från och med version 2207 kan den här egenskapen användas för att hoppa över att kontrollera certifikatets ämnesnamn. CCMCERTNAMECHECK=0 hoppar över att kontrollera certifikatets ämnesnamn.

CCMCERTSEL

Om klienten har fler än ett certifikat för HTTPS-kommunikation anger den här egenskapen villkoren för att välja ett giltigt klientautentiseringscertifikat.

Använd följande nyckelord för att söka i certifikatets ämnesnamn eller alternativa ämnesnamn:

  • Subject: Hitta en exakt matchning
  • SubjectStr: Hitta en delvis matchning

Exempel:

  • CCMCERTSEL="Subject:computer1.contoso.com": Sök efter ett certifikat med en exakt matchning till datornamnet computer1.contoso.com i ämnesnamnet eller det alternativa ämnesnamnet.

  • CCMCERTSEL="SubjectStr:contoso.com": Sök efter ett certifikat som innehåller contoso.com i ämnesnamnet eller det alternativa ämnesnamnet.

Använd nyckelordet SubjectAttr för att söka efter objektidentifieraren (OID) eller unika namnattribut i ämnesnamnet eller det alternativa ämnesnamnet.

Exempel:

  • CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": Sök efter organisationsenhetsattributet skrivet som en objektidentifierare med namnet Computers.

  • CCMCERTSEL="SubjectAttr:OU = Computers": Sök efter organisationsenhetsattributet skrivet som ett unikt namn och med namnet Computers.

Viktigt

Om du använder ämnesnamnet är nyckelordet Subject skiftlägeskänsligt och nyckelordet SubjectStr är skiftlägesokänsligt.

Om du använder alternativt ämnesnamn är varken Subject eller nyckelorden SubjectStr skiftlägeskänsliga.

En fullständig lista över attribut som du kan använda för val av certifikat finns i Attributvärden som stöds för urvalskriterier för PKI-certifikat.

Om fler än ett certifikat matchar sökningen och du anger CCMFIRSTCERT till 1 väljer klientinstallationsprogrammet det certifikat med längst giltighetsperiod.

CCMCERTSTORE

Om klientinstallationsprogrammet inte kan hitta ett giltigt certifikat i det vanliga certifikatarkivet Personligt på datorn använder du den här egenskapen för att ange ett alternativt certifikatarkivnamn.

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

CCMDEBUGLOGGING

Den här egenskapen aktiverar felsökningsloggning när klienten installeras. Den här egenskapen gör att klienten loggar felsökning med information på låg nivå. Undvik att använda den här egenskapen på produktionsplatser. Överdriven loggning kan inträffa, vilket kan göra det svårt att hitta relevant information i loggfilerna. Aktivera även CCMENABLELOGGING.

Värden som stöds:

  • 0: Inaktivera felsökningsloggning (standard)
  • 1: Aktivera felsökningsloggning

Exempel: CCMSetup.exe CCMDEBUGLOGGING=1

Mer information finns i Om loggfiler.

CCMENABLELOGGING

Som standard aktiverar Configuration Manager loggning.

Värden som stöds:

  • TRUE: Aktivera loggning (standard)
  • FALSE: Inaktivera loggning

Exempel: CCMSetup.exe CCMENABLELOGGING=TRUE

Mer information finns i Om loggfiler.

CCMEVALINTERVAL

Den frekvens i minuter som utvärderingsverktyget för klienthälsa (ccmeval.exe) körs med. Ange ett heltalsvärde från 1 till 1440. Som standard körs ccmeval en gång om dagen (1 440 minuter).

Exempel: CCMSetup.exe CCMEVALINTERVAL=1440

Mer information om utvärdering av klienthälsa finns i Övervakningsklienter.

CCMEVALHOUR

Den timme på dagen då utvärderingsverktyget för klienthälsa (ccmeval.exe) körs. Ange ett heltalsvärde från 0 (midnatt) till 23 (23:00). Som standard körs ccmeval vid midnatt.

Mer information om utvärdering av klienthälsa finns i Övervakningsklienter.

CCMFIRSTCERT

Om du ställer in den här egenskapen till 1 väljer klienten det PKI-certifikat med den längsta giltighetsperioden.

Exempel: CCMSetup.exe /UsePKICert CCMFIRSTCERT=1

CCMHOSTNAME

Om klienten hanteras via Internet anger den här egenskapen det FQDN för den Internetbaserade hanteringsplatsen.

Ange inte det här alternativet med installationsegenskapen SMSSITECODE=AUTO. Tilldela internetbaserade klienter direkt till en Internetbaserad webbplats.

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

Den här egenskapen kan ange adressen till en CMG (Cloud Management Gateway). Använd följande steg för att hämta värdet för den här egenskapen:

  • Skapa en CMG. Mer information finns i Konfigurera en CMG.

  • Öppna en Windows PowerShell-kommandotolk som administratör på en aktiv klient.

  • Kör följande kommando:

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

  • Använd det returnerade värdet som det är med egenskapen CCMHOSTNAME.

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

Viktigt

När du anger adressen till en CMG för egenskapen CCMHOSTNAME ska du inte lägga till ett prefix, t.ex. https://. Använd endast det här prefixet med /mp-URL:en för en CMG.

CCMHTTPPORT

Anger porten som klienten ska använda när den kommunicerar via HTTP till platssystemservrar. Som standard är det här värdet 80.

Exempel: CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORT

Anger porten som klienten ska använda när den kommunicerar via HTTPS till platssystemservrar. Som standard är det här värdet 443.

Exempel: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

Använd den här egenskapen för att ange mappen som ska installera klientfilerna för Configuration Manager. Som standard används %WinDir%\CCM.

Tips

Oavsett var du installerar klientfilerna installeras alltid filen ccmcore.dll i mappen %WinDir%\System32. I ett 64-bitars operativsystem installeras en kopia av ccmcore.dll i mappen %WinDir%\SysWOW64. Den här filen stöder 32-bitarsprogram som använder 32-bitarsversionen av klient-API:erna från Configuration Manager SDK.

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

CCMLOGLEVEL

Använd den här egenskapen för att ange den detaljnivå som ska användas i loggfilerna för Configuration Manager.

Värden som stöds:

  • 0: Utförlig
  • 1: Standard
  • 2: Varningar och fel
  • 3: Endast fel

Exempel: CCMSetup.exe CCMLOGLEVEL=0

Mer information finns i Om loggfiler.

CCMLOGMAXHISTORY

När en loggfil från Configuration Manager uppnår den maximala storleken ändrar klienten den till en säkerhetskopia och skapar en ny loggfil. Den här egenskapen anger hur många tidigare versioner av loggfilen som ska behållas. Standardvärdet är 1. Om du ställer in värdet till 0 behåller inte klienten någon loggfilshistorik.

Exempel: CCMSetup.exe CCMLOGMAXHISTORY=5

Mer information finns i Om loggfiler.

CCMLOGMAXSIZE

Den här egenskapen anger loggfilens maximala storlek i byte. När en logg expanderar till den angivna storleken ändrar klienten den till en historikfil och skapar därefter en ny. Standardstorleken är 250 000 byte och den minsta storleken är 10 000 byte.

Exempel: CCMSetup.exe CCMLOGMAXSIZE=300000 (300 000 byte)

DISABLESITEOPT

Ställ in den här egenskapen till TRUE för att blockera administratörer från att ändra den tilldelade webbplatsen på kontrollpanelen för Configuration Manager.

Exempel: CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

Om värdet är TRUE inaktiverar den här egenskapen möjligheten för administrativa användare att ändra inställningarna för klientcachemappen på kontrollpanelen för Configuration Manager.

Exempel: CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIX

Ange en DNS-domän så att klienter kan hitta hanteringsplatser som du publicerar i DNS. När klienten hittar en hanteringsplats meddelar platsen klienten om andra hanteringsplatser i hierarkin. Detta innebär att hanteringsplatsen som klienten hittar från DNS kan vara vilken som helst i hierarkin.

Obs!

Du behöver inte ange den här egenskapen om klienten finns i samma domän som en publicerad hanteringsplats. I sådana fall används klientens domän automatiskt för att söka i DNS efter hanteringsplatser.

Mer information om DNS-publicering som en tjänstplatsmetod för Configuration Manager-klienter finns i Tjänstplats och hur klienter bestämmer sin tilldelade hanteringsplats.

Obs!

Som standard aktiverar Configuration Manager inte DNS-publicering.

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

FSP

Ange återställningsstatuspunkten som tar emot och bearbetar statusmeddelanden som skickas från Configuration Manager-klienter.

Mer information finns i Avgör om du behöver en återställningsstatuspunkt.

Exempel: CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

Om du ställer in den här egenskapen till TRUE kontrollerar inte klientinstallationsprogrammet den lägsta versionen av Microsoft Application Virtualization (App-V) som krävs.

Viktigt

Om du installerar Configuration Manager-klienen utan att installera App-V går det inte att distribuera virtuella program.

Exempel: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

MANAGEDINSTALLER

Om du anger den här egenskapen till 1 anges ccmsetup.exe och client.msi som hanterade installationsprogram. Mer information finns i Automatiskt tillåta appar som distribueras av ett hanterat installationsprogram med Windows Defender Application Control.

Exempel: CCMSetup.exe MANAGEDINSTALLER=1

NOTIFYONLY

När du aktiverar den här egenskapen rapporterar klienten status, men åtgärdar inte problem som hittas.

Exempel: CCMSetup.exe NOTIFYONLY=TRUE

Mer information finns i Så här konfigurerar du klientstatus.

PROVISIONTS

Använd den här egenskapen för att starta en aktivitetssekvens på en klient när den har registrerats på platsen.

Obs!

Om aktivitetssekvensen installerar programuppdateringar eller program behöver klienterna ett giltigt klientautentiseringscertifikat. Enbart tokenautentisering fungerar inte.

Du kan t.ex. etablera en ny Windows-enhet med Windows Autopilot, registrera den automatiskt för Microsoft Intune och installera Configuration Manager-klienten för samhantering. Om du anger det nya alternativet kommer den nyligen etablerade klienten att köra en aktivitetssekvens. Den här processen ger dig ytterligare flexibilitet att installera program och programuppdateringar eller konfigurera inställningar.

Använd följande process:

  1. Skapa en aktivitetssekvens som inte är en OS-distribution för att installera appar, programuppdateringar och konfigurera inställningar.

  2. Distribuera aktivitetssekvensen till den nya inbyggda samlingen Alla etableringsenheter. Observera distributions-ID:t för aktivitetssekvensen, exempelvis PRI20001.

    Tips

    Distributionens syfte kan vara antingen tillgängligt eller obligatoriskt. Eftersom du anger distributions-ID som egenskapsvärde spelar syftet ingen roll.

  3. Installera Configuration Manager-klienten på en enhet med ccmsetup.msi och inkludera följande egenskap: PROVISIONTS=PRI20001. Ange värdet för den här egenskapen som distributions-ID för aktivitetssekvensen.

    • Om du installerar klienten från Intune under registreringen av samhantering läser du Så här förbereder du Internetbaserade enheter för samhantering.

      Obs!

      Den här metoden kan ha ytterligare krav. Du kan till exempel registrera webbplatsen till Microsoft Entra-ID eller skapa en innehållsaktiverad molnhanteringsgateway.

      Oavsett metod använder du bara den här egenskapen med ccmsetup.msi.

När klienten har installerats och registrerats korrekt på platsen startas den refererade aktivitetssekvensen. Om klientregistreringen misslyckas startar inte aktivitetssekvensen.

Obs!

Aktivitetssekvensen som startas av PROVISIONTS använder Standardinställningar för klient. Den här aktivitetssekvensen startar omedelbart efter att klienten har registrerats. Den ingår inte i någon samling som du har distribuerat anpassade klientinställningar till. Klienten bearbetar eller tillämpar inte anpassade klientinställningar innan den här aktivitetssekvensen körs.

För att aktivitetssekvensen ska fungera korrekt kan du behöva ändra vissa inställningar i Standardinställningar för klient. Till exempel:

  • Grupp för Cloud Services: Gör det möjligt för klienter att använda Cloud Management Gateway och Tillåt åtkomst till molndistributionsplats
  • Grupp för Datoragent: Körningsprincip för PowerShell

Om enheterna inte behöver dessa klientinställningar när aktivitetssekvensen har slutförts distribuerar du nya anpassade klientinställningar för att ändra standardinställningarna.

Mer information finns i Om klientinställningar.

RESETKEYINFORMATION

Om en klient har fel betrodd rotnyckel för Configuration Manager kan den inte kontakta en betrodd hanteringsplats för att ta emot den nya betrodda rotnyckeln. Använd den här egenskapen för att ta bort den gamla betrodda rotnyckeln. Den här situationen kan uppstå när du flyttar en klient från en platshierarki till en annan. Den här egenskapen gäller för klienter som använder HTTP- och HTTPS-klientkommunikation. Mer information finns i Planera för den betrodda rotnyckeln.

Exempel: CCMSetup.exe RESETKEYINFORMATION=TRUE

SITEREASSIGN

Aktiverar automatisk platstilldelning för klientuppgraderingar när det används med SMSSITECODE=AUTO.

Exempel: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE

SMSCACHEDIR

Anger platsen för klientens cachemapp på klientdatorn. Som standard är cacheplatsen %WinDir%\ccmcache.

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

Använd den här egenskapen med egenskapen SMSCACHEFLAGS för att styra platsen för klientens cachemapp. Om du t.ex. vill installera klientens cachemapp på den största tillgängliga klientdiskenheten: CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE

SMSCACHEFLAGS

Använd den här egenskapen om du vill ange ytterligare installationsinformation för klientens cachemapp. Du kan använda egenskaperna SMSCACHEFLAGS individuellt eller i kombination avgränsade med semikolon (;).

Om du inte inkluderar den här egenskapen:

  • Klienten installerar cachemappen enligt egenskapen SMSCACHEDIR
  • Mappen är inte komprimerad
  • Klienten använder egenskapen SMSCACHESIZE som storleksgräns i MB för cacheminnet

När du uppgraderar en befintlig klient ignorerar klientinstallationsprogrammet den här egenskapen.

Värden för egenskapen SMSCACHEFLAGS

  • PERCENTDISKSPACE: Ange cachestorleken som en procentandel av det totala diskutrymmet. Om du anger den här egenskapen anger du även SMSCACHESIZE till ett procentvärde.

  • PERCENTFREEDISKSPACE: Ange cachestorleken som en procentandel av det lediga diskutrymmet. Om du anger den här egenskapen anger du även SMSCACHESIZE som ett procentvärde. Disken har exempelvis 10 MB ledigt och du anger SMSCACHESIZE=50. Klientinstallationsprogrammet anger cachestorleken till 5 MB. Du kan inte använda den här egenskapen med egenskapen PERCENTDISKSPACE.

  • MAXDRIVE: Installera cacheminnet på den största tillgängliga disken. Om du anger en sökväg med egenskapen SMSCACHEDIR ignorerar klientinstallationsprogrammet det här värdet.

  • MAXDRIVESPACE: Installera cacheminnet på diskenheten med mest ledigt utrymme. Om du anger en sökväg med egenskapen SMSCACHEDIR ignorerar klientinstallationsprogrammet det här värdet.

  • NTFSONLY: Installera cacheminnet endast på en NTFS-formaterad diskenhet. Om du anger en sökväg med egenskapen SMSCACHEDIR ignorerar klientinstallationsprogrammet det här värdet.

  • COMPRESS: Lagra cacheminnet i ett komprimerat format.

  • FAILIFNOSPACE: Om det inte finns tillräckligt med utrymme för att installera cacheminnet tar du bort Configuration Manager-klienten.

Exempel: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

Viktigt

Klientinställningar finns tillgängliga för att ange storleken på klientens cachemapp. Tillägget av dessa klientinställningar ersätter effektivt användningen av SMSCACHESIZE som en client.msi-egenskap för att ange storleken på klientcacheminnet. Mer information finns i klientinställningar för cachestorlek.

När du uppgraderar en befintlig klient ignorerar klientinstallationsprogrammet den här inställningen. Klienten ignorerar cachestorleken när den laddar ned programuppdateringar.

Exempel: CCMSetup.exe SMSCACHESIZE=100

Obs!

Om du installerar om en klient kan du inte använda SMSCACHESIZE eller SMSCACHEFLAGS för att ange cachestorleken till mindre än den var tidigare. Den tidigare storleken är minimivärdet.

SMSCONFIGSOURCE

Använd den här egenskapen för att ange den plats och ordning som klientinstallationsprogrammet använder vid sökning efter konfigurationsinställningar. Det är en sträng med ett eller flera tecken som var och ett definierar en specifik konfigurationskälla:

  • R: Sök efter konfigurationsinställningar i registret.

    Mer information finns i Etablera egenskaper för klientinstallation.

  • P: Sök efter konfigurationsinställningar i installationsegenskaperna från kommandoraden.

  • M: Sök efter befintliga inställningar när du uppgraderar en äldre klient.

  • U: Uppgradera den installerade klienten till en nyare version och använd den tilldelade platskoden.

Som standard använder klientinstallationsprogrammet PU. Först kontrolleras installationsegenskaperna (P) och sedan de befintliga inställningarna (U).

Exempel: CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMP

Anger en första hanteringsplats som Configuration Manager-klienten ska använda.

Viktigt

Om hanteringsplatsen endast accepterar klientanslutningar via HTTPS lägger du till https:// i hanteringsplatsens namn som ett prefix.

Exempel:

  • CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSMPLIST

Anger en lista över hanteringsplatser som Configuration Manager-klienten ska använda. Använd semikolon (;) som avgränsare när du anger flera hanteringsplatser.

Viktigt

Om hanteringsplatsen endast accepterar klientanslutningar via HTTPS lägger du till https:// i hanteringsplatsens namn som ett prefix.

Exempel:

  • 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

Om klienten inte kan hämta den betrodda rotnyckeln för Configuration Manager från Active Directory Domain Services använder du den här egenskapen för att ange nyckeln. Den här egenskapen gäller för klienter som använder HTTP- och HTTPS-kommunikation. Mer information finns i Planera för den betrodda rotnyckeln.

Exempel: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

Tips

Hämta värdet för platsens betrodda rotnyckel från filen mobileclient.tcf på platsservern. Mer information finns i Företablera en klient med den betrodda rotnyckeln med hjälp av en fil.

SMSROOTKEYPATH

Använd den här egenskapen om du vill installera om den betrodda rotnyckeln för Configuration Manager. Den anger den fullständiga sökvägen och namnet på en fil som innehåller den betrodda rotnyckeln. Den här egenskapen gäller för klienter som använder HTTP- och HTTPS-klientkommunikation. Mer information finns i Planera för den betrodda rotnyckeln.

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

SMSSIGNCERT

Anger den fullständiga sökvägen och namnet på det exporterade självsignerade certifikatet på platsservern. Platsservern lagrar det här certifikatet i certifikatarkivet SMS. Den har ämnesnamnet Platsserver och det egna namnet Signeringscertifikat för platsserver.

Exportera certifikatet utan den privata nyckeln, lagra filen på ett säkert sätt och få åtkomst till den endast från en skyddad kanal.

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

SMSSITECODE

Den här egenskapen anger en Configuration Manager-plats som du tilldelar klienten till. Det här värdet kan antingen vara en platskod med tre tecken eller ordet AUTO. Om du anger AUTO, eller inte anger den här egenskapen, försöker klienten fastställa sin platstilldelning från Active Directory Domain Services eller från en angiven hanteringsplats. Om du vill aktivera AUTO för klientuppgraderingar anger du även SITEREASSIGN=TRUE.

Obs!

Om du anger en Internetbaserad hanteringsplats med egenskapen CCMHOSTNAME ska du inte använda AUTO med SMSSITECODE. Tilldela klienten direkt till platsen genom att ange platskoden.

Exempel: CCMSetup.exe SMSSITECODE=XZY

UPGRADETOLATEST

Den här egenskapen tvingar CCMSetup att skicka en platsbegäran till hanteringsplatsen för att hämta den senaste versionen av klientinstallationskällan för Configuration Manager. Det finns flera scenarier där den här egenskapen är särskilt användbar:

  • Förproduktionsklienter. En nyligen installerad klient använder produktionsbaslinjen eftersom den inte kan utvärdera förproduktionssamlingen förrän klienten har installerats. När klienten har installerats och utvärderat principen i det scenariot uppgraderas den senare till förproduktionsklientversionen. Använd den här egenskapen så att enheten omedelbart installerar den senaste versionen av klienten.

    Det här scenariot omfattar även när du använder Autopilot i samhantering. Använd den här egenskapen för att se till att den nyligen etablerade Autopilot-enheten använder förproduktionsklientversionen direkt.

  • Mottagardistributionsplatser. Tillåt att mottagardistributionsplatser installerar den senaste klientversionen även om den inte finns i förproduktionssamlingen. Den här åtgärden ser till att klientversionen på mottagardistributionsplatsen är densamma som distributionsplatsens binärfiler. Om dessa versioner inte är desamma kan det orsaka problem.

Attributvärden för urvalskriterier för certifikat

Configuration Manager har stöd för följande attributvärden för PKI-certifikatets urvalskriterier:

OID-attribut Attribut för unikt namn Attributdefinition
0.9.2342.19200300.100.1.25 DC Domänkomponent
1.2.840.113549.1.9.1 E eller E-mail E-postadress
2.5.4.3 CN Nätverksnamn
2.5.4.4 SN Ämnesnamn
2.5.4.5 SERIALNUMBER Serienummer
2.5.4.6 C Landskod
2.5.4.7 L Plats
2.5.4.8 S eller ST Land eller region
2.5.4.9 STREET Gatuadress
2.5.4.10 O Organisationsnamn
2.5.4.11 OU Organisationsenhet
2.5.4.12 T eller Title Rubrik
2.5.4.42 G eller GN eller GivenName Förnamn
2.5.4.43 I eller Initials Initialer
2.5.29.17 (inget värde) Alternativt ämnesnamn

Push-installation av klient

Om du använder metoden push-installation av klient ska du använda följande alternativ på fliken Klient på Egenskaper för push-installation av klient i Configuration Manager-konsolen:

  • Någon av egenskaperna för Client.msi

  • Följande delmängd av kommandoradsparametrarna CCMSetup.exe tillåts för klient-push:

    • /AllowMetered (från och med version 2103)

    • /AlwaysExcludeUpgrade

    • /BITSPriority

    • /downloadtimeout

    • /ExcludeFeatures

    • /forcereboot

    • /logon

    • /skipprereq

    • /UsePKICert