Om parametrar och egenskaper för klientinstallationen i Configuration Manager
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:
- Befintlig lokal klientprincip
- Den sista kommandoraden som lagras i Windows-registret
- 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 automatisktFALSE: 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:
FOREGROUNDHIGHNORMAL(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
/noserviceplacerar 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"}).MPLä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.exeCCMSetup.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 /statusI avsnittet Enhetstillstånd letar du reda på värdet TenantId. Till exempel
TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49aObs!
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 matchningSubjectStr: Hitta en delvis matchning
Exempel:
CCMCERTSEL="Subject:computer1.contoso.com": Sök efter ett certifikat med en exakt matchning till datornamnetcomputer1.contoso.comi ämnesnamnet eller det alternativa ämnesnamnet.CCMCERTSEL="SubjectStr:contoso.com": Sök efter ett certifikat som innehållercontoso.comi ä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 namnetComputers.CCMCERTSEL="SubjectAttr:OU = Computers": Sök efter organisationsenhetsattributet skrivet som ett unikt namn och med namnetComputers.
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"}).MPAnvä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örlig1: Standard2: Varningar och fel3: 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:
Skapa en aktivitetssekvens som inte är en OS-distribution för att installera appar, programuppdateringar och konfigurera inställningar.
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.
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
SMSCACHESIZEsom 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 ävenSMSCACHESIZEtill ett procentvärde.PERCENTFREEDISKSPACE: Ange cachestorleken som en procentandel av det lediga diskutrymmet. Om du anger den här egenskapen anger du ävenSMSCACHESIZEsom ett procentvärde. Disken har exempelvis 10 MB ledigt och du angerSMSCACHESIZE=50. Klientinstallationsprogrammet anger cachestorleken till 5 MB. Du kan inte använda den här egenskapen med egenskapenPERCENTDISKSPACE.MAXDRIVE: Installera cacheminnet på den största tillgängliga disken. Om du anger en sökväg med egenskapenSMSCACHEDIRignorerar klientinstallationsprogrammet det här värdet.MAXDRIVESPACE: Installera cacheminnet på diskenheten med mest ledigt utrymme. Om du anger en sökväg med egenskapenSMSCACHEDIRignorerar klientinstallationsprogrammet det här värdet.NTFSONLY: Installera cacheminnet endast på en NTFS-formaterad diskenhet. Om du anger en sökväg med egenskapenSMSCACHEDIRignorerar 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.comCCMSetup.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.comCCMSetup.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
Feedback
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för