Informazioni sui parametri e sulle proprietà di installazione client in Configuration Manager

  • Articolo

Si applica a: Configuration Manager (Current Branch)

Usare il comando CCMSetup.exe per installare il client Configuration Manager. Se si specificano i parametri di installazione client nella riga di comando, modificano il comportamento di installazione. Se si specificano le proprietà di installazione client nella riga di comando, modificano la configurazione iniziale dell'agente client installato.

Informazioni su CCMSetup.exe

Il comando CCMSetup.exe scarica i file necessari per installare il client da un punto di gestione o da un percorso di origine. Questi file possono includere:

  • Il pacchetto di Windows Installer client.msi che installa il software client

  • Prerequisiti client

  • Aggiornamenti e correzioni per il client Configuration Manager

Nota

Non è possibile installare direttamente client.msi.

CCMSetup.exe fornisce parametri della riga di comando per personalizzare l'installazione. I parametri sono preceduti da una barra (/) e sono in genere minuscoli. Quando necessario, specificare il valore di un parametro usando due punti (:) immediatamente seguiti dal valore . Per altre informazioni, vedere CCMSetup.exe parametri della riga di comando.

È anche possibile specificare proprietà nella riga di comando CCMSetup.exe per modificare il comportamento di client.msi. Le proprietà per convenzione sono maiuscole. Specificare un valore per una proprietà usando un segno di uguale (=) immediatamente seguito dal valore . Per altre informazioni, vedere Client.msi proprietà.

Importante

Specificare i parametri CCMSetup prima di specificare le proprietà per client.msi.

CCMSetup.exe e i file di supporto si trovano nel server del sito nella cartella Client della cartella di installazione Configuration Manager. Configuration Manager condivide questa cartella nella rete nella condivisione del sito. Ad esempio, \\SiteServer\SMS_ABC\Client.

Al prompt dei comandi, il comando CCMSetup.exe usa il formato seguente:

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

Ad esempio:

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

Questo esempio esegue le operazioni seguenti:

  • Specifica il punto di gestione denominato SMSMP01 per richiedere un elenco di punti di distribuzione per scaricare i file di installazione client.

  • Specifica che l'installazione deve essere interrotta se nel computer esiste già una versione del client.

  • Indica client.msi di assegnare il client al codice del sito S01.

  • Indica client.msi di usare il punto di stato di fallback denominato SMSFP01.

Consiglio

Se un valore di parametro ha spazi, racchiuderlo tra virgolette.

Se si estende lo schema di Active Directory per Configuration Manager, il sito pubblica molte proprietà di installazione client in Active Directory Domain Services. Il client Configuration Manager legge automaticamente queste proprietà. Per altre informazioni, vedere Informazioni sulle proprietà di installazione client pubblicate in Active Directory Domain Services

CCMSetup.exe parametri della riga di comando

/?

Mostra i parametri della riga di comando disponibili per ccmsetup.exe.

Esempio: ccmsetup.exe /?

/AllowMetered

Usare questo parametro per controllare il comportamento del client in una rete a consumo. Questo parametro non accetta valori. Quando si consente la comunicazione client in una rete a consumo per ccmsetup, il contenuto viene scaricato, registrato nel sito e scaricato i criteri iniziali. Qualsiasi altra comunicazione client segue la configurazione dell'impostazione client da tale criterio. Per altre informazioni, vedere Informazioni sulle impostazioni client.

Se si reinstalla il client in un dispositivo esistente, viene usata la priorità seguente per determinarne la configurazione:

  1. Criteri client locali esistenti
  2. Ultima riga di comando archiviata nel Registro di sistema di Windows
  3. Parametri nella riga di comando ccmsetup

/AlwaysExcludeUpgrade

Questo parametro specifica se un client eseguirà o meno l'aggiornamento automatico quando si abilita l'aggiornamento client automatico.

Valori supportati:

  • TRUE: il client non eseguirà automaticamente l'aggiornamento
  • FALSE: il client viene aggiornato automaticamente (impostazione predefinita)

Ad esempio:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

Per altre informazioni, vedere Client di interoperabilità estesa.

Nota

Quando si usa il /AlwaysExcludeUpgrade parametro , l'aggiornamento automatico viene ancora eseguito. Tuttavia, quando CCMSetup viene eseguito per eseguire l'aggiornamento, si noterà che /AlwaysExcludeUpgrade il parametro è stato impostato e registrerà la riga seguente nel file ccmsetup.log:

Client is stamped with /alwaysexcludeupgrade. Stop proceeding.

CCMSetup quindi uscirà immediatamente e non eseguirà l'aggiornamento.

/BITSPriority

Quando il dispositivo scarica i file di installazione client tramite una connessione HTTP, usare questo parametro per specificare la priorità di download. Specificare uno dei valori possibili seguenti:

  • FOREGROUND

  • HIGH

  • NORMAL (impostazione predefinita)

  • LOW

Esempio: ccmsetup.exe /BITSPriority:HIGH

/config

Questo parametro specifica un file di testo che elenca le proprietà di installazione client.

  • Se CCMSetup viene eseguito come servizio, inserire questo file nella cartella di sistema CCMSetup: %Windir%\Ccmsetup.

  • Se si specifica il /noservice parametro , inserire questo file nella stessa cartella di CCMSetup.exe.

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

Per specificare il formato di file corretto, usare il file mobileclienttemplate.tcf nella \bin\<platform> cartella nella directory di installazione Configuration Manager nel server del sito. Questo file contiene commenti sulle sezioni e su come usarle. Specificare le proprietà di installazione client nella [Client Install] sezione , dopo il testo seguente: Install=INSTALL=ALL.

Voce di sezione di esempio [Client Install] : Install=INSTALL=ALL SMSSITECODE=ABC SMSCACHESIZE=100

/downloadtimeout

Se CCMSetup non riesce a scaricare i file di installazione client, questo parametro specifica il timeout massimo in minuti. Dopo questo timeout, CCMSetup interrompe il tentativo di scaricare i file di installazione. Il valore predefinito è 1440 minuti (un giorno).

Utilizzare il /retry parametro per specificare l'intervallo tra tentativi di ripetizione dei tentativi.

Esempio: ccmsetup.exe /downloadtimeout:100

/ExcludeFeatures

Questo parametro specifica che CCMSetup.exe non installa la funzionalità specificata.

Esempio: CCMSetup.exe /ExcludeFeatures:ClientUI non installa Software Center nel client.

Nota

ClientUI è l'unico valore supportato dal /ExcludeFeatures parametro .

/forceinstall

Specificare che CCMSetup.exe disinstalla qualsiasi client esistente e installa un nuovo client.

/forcereboot

Usare questo parametro per forzare il riavvio del computer, se necessario, per completare l'installazione. Se non si specifica questo parametro, CCMSetup viene chiuso quando è necessario un riavvio. Continua quindi dopo il successivo riavvio manuale.

Esempio: CCMSetup.exe /forcereboot

/logon

Se è già installata una versione del client, questo parametro specifica che l'installazione del client deve essere interrotta.

Esempio: ccmsetup.exe /logon

/mp

Specifica un punto di gestione che i client possono usare per trovare il punto di distribuzione più vicino per i file di installazione client. Se non sono presenti punti di distribuzione o i computer non possono scaricare i file dai punti di distribuzione dopo quattro ore, scaricano i file dal punto di gestione specificato.

Per altre informazioni sul modo in cui ccmsetup scarica il contenuto, vedere Gruppi di limiti - Installazione client. Questo articolo include anche i dettagli del comportamento di ccmsetup se si usano entrambi i /mp parametri e /source .

Importante

Questo parametro specifica un punto di gestione iniziale per consentire ai computer di trovare un'origine di download e può essere qualsiasi punto di gestione in qualsiasi sito. Non assegna il client al punto di gestione specificato.

I computer scaricano i file tramite una connessione HTTP o HTTPS, a seconda della configurazione del ruolo del sistema del sito per le connessioni client. Il download può anche usare la limitazione BITS se viene configurata. Se si configurano tutti i punti di distribuzione e i punti di gestione solo per le connessioni client HTTPS, verificare che il computer client disponga di un certificato client valido.

È possibile usare il parametro della /mp riga di comando per specificare più punti di gestione. Se il computer non riesce a connettersi al primo, tenta il successivo nell'elenco specificato. Quando si specificano più punti di gestione, separare i valori in punti e virgola.

Se il client si connette a un punto di gestione tramite HTTPS, specificare il nome di dominio completo e non il nome del computer. Il valore deve corrispondere al nome alternativo soggetto o soggetto del certificato PKI del punto di gestione. Anche se Configuration Manager supporta l'uso di un nome computer nel certificato per le connessioni nella Intranet, è consigliabile usare un nome di dominio completo.

Esempio con il nome del computer: ccmsetup.exe /mp:SMSMP01

Esempio con il nome di dominio completo: ccmsetup.exe /mp:smsmp01.contoso.com

Questo parametro può anche specificare l'URL di un gateway di gestione cloud.This parameter can also specify the URL of a cloud management gateway (CMG). Usare questo URL per installare il client in un dispositivo basato su Internet. Per ottenere il valore per questo parametro, seguire questa procedura:

  • Creare un cmg. Per altre informazioni, vedere Configurare un cmg.

  • In un client attivo aprire un prompt dei comandi Windows PowerShell come amministratore.

  • Eseguire il comando riportato di seguito:

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

  • Aggiungere il https:// prefisso da usare con il /mp parametro .

Esempio per quando si usa l'URL del gateway di gestione cloud: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

Importante

Quando si specifica l'URL di un gateway di gestione cloud per il /mp parametro , deve iniziare con https://.

Nota

Il parametro della riga di comando /mp non specifica il punto di gestione usato dal client Configuration Manager dopo l'installazione. Per specificare il punto di gestione iniziale utilizzato dal client Configuration Manager dopo l'installazione, utilizzare la proprietà client.msi SMSMP. Per specificare un elenco di punti di gestione per il client Configuration Manager da usare dopo l'installazione, utilizzare la proprietà client.msi SMSMPLIST.

/NoCRLCheck

Specifica che un client non deve controllare l'elenco di revoche di certificati (CRL) quando comunica tramite HTTPS con un certificato PKI. Quando non si specifica questo parametro, il client controlla l'elenco CRL prima di stabilire una connessione HTTPS. Per altre informazioni sul controllo CRL client, vedere Planning for PKI certificate revocation.For more information about client CRL checking, see Planning for PKI certificate revocation.

Esempio: CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

Questo parametro impedisce l'esecuzione di CCMSetup come servizio, operazione eseguita per impostazione predefinita. Quando CCMSetup viene eseguito come servizio, viene eseguito nel contesto dell'account del sistema locale del computer. Questo account potrebbe non disporre di diritti sufficienti per accedere alle risorse di rete necessarie per l'installazione. Con /noservice, CCMSetup.exe viene eseguito nel contesto dell'account utente usato per avviare l'installazione.

Esempio: ccmsetup.exe /noservice

/regtoken

Usare questo parametro per fornire un token di registrazione bulk. Un dispositivo basato su Internet usa questo token nel processo di registrazione tramite un gateway di gestione cloud . Per altre informazioni, vedere Autenticazione basata su token per CMG.

Quando si usa questo parametro, includere anche i parametri e le proprietà seguenti:

La riga di comando di esempio seguente include gli altri parametri e proprietà di installazione necessari:

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

Consiglio

Se CCMSetup restituisce l'errore 0x87d0027e, provare a rimuovere il /mp parametro dalla riga di comando.

/retry

Se CCMSetup.exe non riesce a scaricare i file di installazione, usare questo parametro per specificare l'intervallo di tentativi in minuti. CCMSetup continua a riprovare finché non raggiunge il limite specificato nel /downloadtimeout parametro .

Esempio: ccmsetup.exe /retry:20

/service

Specifica che CCMSetup deve essere eseguito come servizio che usa l'account di sistema locale.

Consiglio

Se si usa uno script per eseguire CCMSetup.exe con il /service parametro , CCMSetup.exe si chiude dopo l'avvio del servizio. Potrebbe non segnalare correttamente i dettagli di installazione allo script.

Esempio: ccmsetup.exe /service

/skipprereq

Questo parametro specifica che CCMSetup.exe non installa il prerequisito specificato. È possibile immettere più di un valore. Usare il carattere punto e virgola (;) per separare ogni valore.

Esempi:

  • CCMSetup.exe /skipprereq:filename.exe

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

Per altre informazioni sui prerequisiti client, vedere Prerequisiti del client Windows.

/source

Specifica il percorso di download del file. Usare un percorso locale o UNC. Il dispositivo scarica i file usando il protocollo SMB (Server Message Block). Per usare /source, l'account utente di Windows per l'installazione client deve disporre delle autorizzazioni di lettura per il percorso.

Per altre informazioni sul modo in cui ccmsetup scarica il contenuto, vedere Gruppi di limiti - Installazione client. Questo articolo include anche i dettagli del comportamento di ccmsetup se si usano entrambi i /mp parametri e /source .

Consiglio

È possibile usare il /source parametro più volte in una riga di comando per specificare percorsi di download alternativi.

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

/uninstall

Usare questo parametro per disinstallare il client Configuration Manager. Per altre informazioni, vedere Disinstallare il client.

Esempio: ccmsetup.exe /uninstall

Nota

A partire dalla versione 2111, quando si disinstalla il client, viene rimosso anche il bootstrap del client, ccmsetup.msi, se esistente.

/UsePKICert

Specificare questo parametro per consentire al client di usare un certificato di autenticazione client PKI. Se non si include questo parametro o se il client non riesce a trovare un certificato valido, filtra tutti i punti di gestione HTTPS, inclusi i gateway di gestione cloud (CMG). Il client usa una connessione HTTP con un certificato autofirma.

Esempio: CCMSetup.exe /UsePKICert

Se un dispositivo usa Microsoft Entra ID per l'autenticazione client e dispone anche di un certificato di autenticazione client basato su PKI, se si usa include questo parametro il client non sarà in grado di ottenere Microsoft Entra informazioni di onboarding da un gateway di gestione cloud . Per un client che usa l'autenticazione Microsoft Entra, non specificare questo parametro, ma includere le proprietà AADRESOURCEURI e AADCLIENTAPPID.

Nota

In alcuni scenari non è necessario specificare questo parametro, ma usare comunque un certificato client. Ad esempio, il push client e l'installazione client basata su aggiornamento software. Usare questo parametro quando si installa manualmente un client e si usa il /mp parametro con un punto di gestione abilitato per HTTPS.

Specificare anche questo parametro quando si installa un client per la comunicazione solo Internet. Usare CCMALWAYSINF=1 insieme alle proprietà per il punto di gestione basato su Internet (CCMHOSTNAME) e il codice del sito (SMSSITECODE). Per altre informazioni sulla gestione client basata su Internet, vedere Considerazioni sulle comunicazioni client da Internet o da una foresta non attendibile.

/IgnoreSkipUpgrade

Specificare questo parametro per aggiornare manualmente un client escluso. Per altre informazioni, vedere Come escludere i client dall'aggiornamento.

CCMSetup.exe codici restituiti

Il comando CCMSetup.exe fornisce i codici restituiti seguenti. Per risolvere i problemi, esaminare %WinDir%\ccmsetup\Logs\ccmsetup.log nel client il contesto e altri dettagli sui codici restituiti.

Codice restituito Significato
0 Esito positivo
6 Error
7 Riavvio necessario
8 Installazione già in esecuzione
9 Errore di valutazione dei prerequisiti
10 Errore di convalida dell'hash del manifesto dell'installazione

proprietà Ccmsetup.msi

Le proprietà seguenti possono modificare il comportamento di installazione di ccmsetup.msi.

CCMSETUPCMD

Usare questo ccmsetup. proprietà msi per passare parametri e proprietà della riga di comando aggiuntivi a ccmsetup. exe. Includere altri parametri e proprietà tra virgolette ("). Utilizzare questa proprietà quando si esegue il bootstrap del client Configuration Manager con il metodo di installazione MDM di Intune.

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

Consiglio

Microsoft Intune limita la riga di comando a 1024 caratteri.

proprietà Client.msi

Le proprietà seguenti possono modificare il comportamento di installazione di client.msi, che ccmsetup.exe installa.

AADCLIENTAPPID

Specifica l'identificatore dell'app client Microsoft Entra. L'app client viene creata o importata quando si configurano i servizi di Azure per Gestione cloud. Un amministratore di Azure può ottenere il valore per questa proprietà dalla portale di Azure. Per altre informazioni, vedere Ottenere l'ID applicazione. Per la AADCLIENTAPPID proprietà , questo ID applicazione è per il tipo di applicazione nativa .

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

AADRESOURCEURI

Specifica l'identificatore dell'app server Microsoft Entra. L'app server viene creata o importata quando si configurano i servizi di Azure per Gestione cloud. Quando si crea l'app server, nella finestra Crea applicazione server questa proprietà è l'URI dell'ID app.

Un amministratore di Azure può ottenere il valore per questa proprietà dalla portale di Azure. In Microsoft Entra ID individuare l'app server in Registrazioni app. Cercare app Web/API di tipo applicazione. Aprire l'app, selezionare Impostazioni e quindi selezionare Proprietà. Usare il valore dell'URI dell'ID app per questa AADRESOURCEURI proprietà di installazione client.

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

AADTENANTID

Specifica l'identificatore del tenant Microsoft Entra. Configuration Manager collegamenti a questo tenant quando si configurano i servizi di Azure per Gestione cloud. Per ottenere il valore per questa proprietà, seguire questa procedura:

  • In un dispositivo che esegue Windows 10 o versioni successive e viene aggiunto allo stesso tenant Microsoft Entra, aprire un prompt dei comandi.

  • Esegui il comando seguente: dsregcmd.exe /status

  • Nella sezione Stato dispositivo individuare il valore TenantId . Ad esempio, TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49a

    Nota

    Un amministratore di Azure può anche ottenere questo valore nel portale di Azure. Per altre informazioni, vedere Ottenere l'ID tenant.

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

CCMADMINS

Specifica uno o più account utente o gruppi di Windows a cui concedere l'accesso alle impostazioni e ai criteri client. Questa proprietà è utile quando non si dispone di credenziali amministrative locali nel computer client. Specificare un elenco di account separati da punti e virgola (;).

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

CCMALLOWSILENTREBOOT

Se necessario, consentire al computer di riavviare in modo invisibile all'utente dopo l'installazione del client.

Importante

Quando si utilizza questa proprietà, il computer viene riavviato senza avviso. Questo comportamento si verifica anche se un utente ha eseguito l'accesso a Windows.

Esempio: CCMSetup.exe CCMALLOWSILENTREBOOT

CCMALWAYSINF

Per specificare che il client è sempre basato su Internet e non si connette mai alla intranet, impostare questo valore della proprietà su 1. Il tipo di connessione del client visualizza Always Internet.

Utilizzare questa proprietà con CCMHOSTNAME per specificare il nome di dominio completo del punto di gestione basato su Internet. Usarlo anche con il parametro CCMSetup UsePKICert e la proprietà SMSSITECODE .

Per altre informazioni sulla gestione client basata su Internet, vedere Considerazioni sulle comunicazioni client da Internet o da una foresta non attendibile.

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

CCMCERTISSUERS

Utilizzare questa proprietà per specificare l'elenco degli emittenti di certificati. Questo elenco include informazioni sul certificato per le autorità di certificazione radice attendibili considerate attendibili dal sito Configuration Manager.

Questo valore è una corrispondenza con distinzione tra maiuscole e minuscole per gli attributi del soggetto presenti nel certificato CA radice. Separare gli attributi in base a una virgola (,) o a un punto e virgola (;). Specificare più di un certificato CA radice usando una barra separatore (|).

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

Consiglio

Usare il valore dell'attributo CertificateIssuers nel file mobileclient.tcf per il sito. Questo file si trova nella \bin\<platform> sottocartella della directory di installazione Configuration Manager nel server del sito.

Per altre informazioni sull'elenco degli emittenti di certificati e sul modo in cui i client lo usano durante il processo di selezione del certificato, vedere Pianificazione della selezione del certificato client PKI.

CCMCERTNAMECHECK

A partire dalla versione 2207, questa proprietà può essere usata per ignorare la verifica del nome del soggetto per il certificato.CCMCERTNAMECHECK=0 ignora la verifica del nome del soggetto del certificato.

CCMCERTSEL

Se il client dispone di più certificati per la comunicazione HTTPS, questa proprietà specifica i criteri per selezionare un certificato di autenticazione client valido.

Usare le parole chiave seguenti per cercare il nome soggetto del certificato o il nome alternativo del soggetto:

  • Subject: trovare una corrispondenza esatta
  • SubjectStr: trovare una corrispondenza parziale

Esempi:

  • CCMCERTSEL="Subject:computer1.contoso.com": cercare un certificato con una corrispondenza esatta con il nome del computer nel nome computer1.contoso.com soggetto o nel nome alternativo del soggetto.

  • CCMCERTSEL="SubjectStr:contoso.com": cercare un certificato che contiene contoso.com il nome soggetto o il nome alternativo del soggetto.

Usare la SubjectAttr parola chiave per cercare gli attributi OID (Object Identifier) o distinguished name nel nome soggetto o nel nome alternativo del soggetto.

Esempi:

  • CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": cercare l'attributo dell'unità organizzativa espresso come identificatore di oggetto e denominato Computers.

  • CCMCERTSEL="SubjectAttr:OU = Computers": cercare l'attributo dell'unità organizzativa espresso come nome distinto e denominato Computers.

Importante

Se si usa il nome del soggetto, la Subject parola chiave fa distinzione tra maiuscole e minuscole e la SubjectStr parola chiave non fa distinzione tra maiuscole e minuscole.

Se si usa il nome alternativo del soggetto, entrambe le SubjectSubjectStr parole chiave e non fanno distinzione tra maiuscole e minuscole.

Per l'elenco completo degli attributi che è possibile usare per la selezione del certificato, vedere Valori di attributo supportati per i criteri di selezione del certificato PKI.

Se più certificati corrispondono alla ricerca e si imposta su CCMFIRSTCERT1, il programma di installazione client seleziona il certificato con il periodo di validità più lungo.

CCMCERTSTORE

Se il programma di installazione client non riesce a individuare un certificato valido nell'archivio certificati personali predefinito per il computer, utilizzare questa proprietà per specificare un nome di archivio certificati alternativo.

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

CCMDEBUGLOGGING

Questa proprietà abilita la registrazione di debug quando viene installato il client. Questa proprietà fa sì che il client registri informazioni di basso livello per la risoluzione dei problemi. Evitare di utilizzare questa proprietà nei siti di produzione. Può verificarsi una registrazione eccessiva, che potrebbe rendere difficile trovare informazioni rilevanti nei file di log. Abilitare CCMENABLELOGGINGanche .

Valori supportati:

  • 0: disattiva la registrazione di debug (impostazione predefinita)
  • 1: attivare la registrazione di debug

Esempio: CCMSetup.exe CCMDEBUGLOGGING=1

Per altre informazioni, vedere Informazioni sui file di log.

CCMENABLELOGGING

Configuration Manager abilita la registrazione per impostazione predefinita.

Valori supportati:

  • TRUE: attivare la registrazione (impostazione predefinita)
  • FALSE: disattiva la registrazione

Esempio: CCMSetup.exe CCMENABLELOGGING=TRUE

Per altre informazioni, vedere Informazioni sui file di log.

CCMEVALINTERVAL

Frequenza in minuti con cui viene eseguito lo strumento di valutazione dell'integrità del client (ccmeval.exe). Specificare un valore intero da 1 a 1440. Per impostazione predefinita, ccmeval viene eseguito una volta al giorno (1440 minuti).

Esempio: CCMSetup.exe CCMEVALINTERVAL=1440

Per altre informazioni sulla valutazione dell'integrità del client, vedere Monitorare i client.

CCMEVALHOUR

L'ora durante il giorno in cui viene eseguito lo strumento di valutazione dell'integrità del client (ccmeval.exe). Specificare un valore intero compreso tra 0 (mezzanotte) e 23 (23:00). Per impostazione predefinita, ccmeval viene eseguito a mezzanotte.

Per altre informazioni sulla valutazione dell'integrità del client, vedere Monitorare i client.

CCMFIRSTCERT

Se si imposta questa proprietà 1su , il client seleziona il certificato PKI con il periodo di validità più lungo.

Esempio: CCMSetup.exe /UsePKICert CCMFIRSTCERT=1

CCMHOSTNAME

Se il client viene gestito tramite Internet, questa proprietà specifica il nome di dominio completo del punto di gestione basato su Internet.

Non specificare questa opzione con la proprietà di installazione di SMSSITECODE=AUTO. Assegnare direttamente i client basati su Internet a un sito basato su Internet.

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

Questa proprietà può specificare l'indirizzo di un gateway di gestione cloud.This property can specify the address of a cloud management gateway (CMG). Per ottenere il valore per questa proprietà, seguire questa procedura:

  • Creare un cmg. Per altre informazioni, vedere Configurare un cmg.

  • In un client attivo aprire un prompt dei comandi Windows PowerShell come amministratore.

  • Eseguire il comando riportato di seguito:

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

  • Utilizzare il valore restituito così come è con la CCMHOSTNAME proprietà .

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

Importante

Quando si specifica l'indirizzo di un cmg per la CCMHOSTNAME proprietà , non aggiungere un prefisso come https://. Usare questo prefisso solo con l'URL /mp di un cmg.

CCMHTTPPORT

Specifica la porta da usare per il client quando comunica tramite HTTP ai server del sistema del sito. Per impostazione predefinita, questo valore è 80.

Esempio: CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORT

Specifica la porta da usare per il client quando comunica tramite HTTPS ai server del sistema del sito. Per impostazione predefinita, questo valore è 443.

Esempio: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

Utilizzare questa proprietà per impostare la cartella per installare i file client Configuration Manager. Per impostazione predefinita, usa %WinDir%\CCM.

Consiglio

Indipendentemente da dove si installano i file client, viene sempre installato il file ccmcore.dll nella %WinDir%\System32 cartella . In un sistema operativo a 64 bit viene installata una copia di ccmcore.dll nella %WinDir%\SysWOW64 cartella . Questo file supporta applicazioni a 32 bit che usano la versione a 32 bit delle API client dell'SDK Configuration Manager.

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

CCMLOGLEVEL

Utilizzare questa proprietà per specificare il livello di dettaglio da scrivere nei file di log Configuration Manager.

Valori supportati:

  • 0:Dettagliato
  • 1:Predefinito
  • 2: avvisi ed errori
  • 3: solo errori

Esempio: CCMSetup.exe CCMLOGLEVEL=0

Per altre informazioni, vedere Informazioni sui file di log.

CCMLOGMAXHISTORY

Quando un file di log Configuration Manager raggiunge le dimensioni massime, il client lo rinomina come backup e crea un nuovo file di log. Questa proprietà specifica il numero di versioni precedenti del file di log da mantenere. Il valore predefinito è 1. Se si imposta il valore su 0, il client non mantiene alcuna cronologia dei file di log.

Esempio: CCMSetup.exe CCMLOGMAXHISTORY=5

Per altre informazioni, vedere Informazioni sui file di log.

CCMLOGMAXSIZE

Questa proprietà specifica le dimensioni massime del file di log in byte. Quando un log raggiunge le dimensioni specificate, il client lo rinomina come file di cronologia e ne crea uno nuovo. La dimensione predefinita è 250.000 byte e la dimensione minima è 10.000 byte.

Esempio: CCMSetup.exe CCMLOGMAXSIZE=300000 (300.000 byte)

DISABLESITEOPT

Impostare questa proprietà su TRUE per impedire agli amministratori di modificare il sito assegnato nel pannello di controllo Configuration Manager.

Esempio: CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

Se impostata su TRUE, questa proprietà disabilita la possibilità per gli utenti amministratori di modificare le impostazioni della cartella della cache client nel pannello di controllo Configuration Manager.

Esempio: CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIX

Specificare un dominio DNS per i client per individuare i punti di gestione pubblicati in DNS. Quando il client individua un punto di gestione, comunica al client altri punti di gestione nella gerarchia. Questo comportamento significa che il punto di gestione trovato dal client da DNS può essere qualsiasi nella gerarchia.

Nota

Non è necessario specificare questa proprietà se il client si trova nello stesso dominio di un punto di gestione pubblicato. In tal caso, il dominio del client viene usato automaticamente per cercare i punti di gestione in DNS.

Per altre informazioni sulla pubblicazione DNS come metodo di posizione del servizio per i client Configuration Manager, vedere Posizione del servizio e come i client determinano il punto di gestione assegnato.

Nota

Per impostazione predefinita, Configuration Manager non abilita la pubblicazione DNS.

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

FSP

Specificare il punto di stato di fallback che riceve ed elabora i messaggi di stato inviati dai client Configuration Manager.

Per altre informazioni, vedere Determinare se è necessario un punto di stato di fallback.

Esempio: CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

Se si imposta questa proprietà TRUEsu , il programma di installazione client non controlla la versione minima richiesta di Microsoft Application Virtualization (App-V).

Importante

Se si installa il client Configuration Manager senza installare App-V, non è possibile distribuire applicazioni virtuali.

Esempio: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

MANAGEDINSTALLER

Se si imposta questa proprietà su 1 , ccmsetup.exe e client.msi vengono impostati come programmi di installazione gestiti. Per altre informazioni, vedere Consentire automaticamente le app distribuite da un programma di installazione gestito con Windows Defender controllo delle applicazioni.

Esempio: CCMSetup.exe MANAGEDINSTALLER=1

NOTIFYONLY

Quando si abilita questa proprietà, il client segnala lo stato, ma non risolve i problemi rilevati.

Esempio: CCMSetup.exe NOTIFYONLY=TRUE

Per altre informazioni, vedere Come configurare lo stato del client.

PROVISIONTS

Utilizzare questa proprietà per avviare una sequenza di attività in un client dopo la corretta registrazione nel sito.

Nota

Se la sequenza di attività installa gli aggiornamenti software o le applicazioni, i client necessitano di un certificato di autenticazione client valido. L'autenticazione dei token da sola non funziona.

Ad esempio, si effettua il provisioning di un nuovo dispositivo Windows con Windows Autopilot, lo si registra automaticamente in Microsoft Intune e quindi si installa il client Configuration Manager per la co-gestione. Se si specifica questa nuova opzione, il client di cui è stato eseguito il provisioning esegue quindi una sequenza di attività. Questo processo offre ulteriore flessibilità per installare applicazioni e aggiornamenti software o configurare le impostazioni.

Usare il processo seguente:

  1. Creare una sequenza di attività di distribuzione non del sistema operativo per installare le app, installare gli aggiornamenti software e configurare le impostazioni.

  2. Distribuire questa sequenza di attività nella nuova raccolta predefinita Tutti i dispositivi di provisioning. Si noti l'ID di distribuzione della sequenza di attività, ad esempio PRI20001.

    Consiglio

    Lo scopo della distribuzione può essere disponibile o obbligatorio. Poiché si specifica l'ID di distribuzione come valore della proprietà, lo scopo non è importante.

  3. Installare il client Configuration Manager in un dispositivo usando ccmsetup.msie includere la proprietà seguente: PROVISIONTS=PRI20001. Impostare il valore di questa proprietà come ID di distribuzione della sequenza di attività.

    • Se si installa il client da Intune durante la registrazione di co-gestione, vedere Come preparare i dispositivi basati su Internet per la co-gestione.

      Nota

      Questo metodo può avere prerequisiti aggiuntivi. Ad esempio, la registrazione del sito nell'ID Microsoft Entra o la creazione di un gateway di gestione cloud abilitato per il contenuto.

      Indipendentemente dal metodo , utilizzare questa proprietà solo con ccmsetup.msi.

Dopo che il client ha installato e registrato correttamente il sito, avvia la sequenza di attività a cui si fa riferimento. Se la registrazione client non riesce, la sequenza di attività non verrà avviata.

Nota

La sequenza di attività avviata da PROVISIONTS usa impostazioni client predefinite. Questa sequenza di attività viene avviata immediatamente dopo la registrazione del client, quindi non farà parte di alcuna raccolta in cui sono state distribuite le impostazioni client personalizzate. Il client non elabora o applica impostazioni client personalizzate prima dell'esecuzione di questa sequenza di attività.

Per il corretto funzionamento della sequenza di attività, potrebbe essere necessario modificare determinate impostazioni in Impostazioni client predefinite. Ad esempio:

  • Servizi cloud gruppo: abilitare i client per l'uso di un gateway di gestione cloud e Consentire l'accesso al punto di distribuzione cloud
  • Gruppo agente computer : criteri di esecuzione di PowerShell

Se i dispositivi non necessitano di queste impostazioni client al termine della sequenza di attività, distribuire nuove impostazioni client personalizzate per invertire le impostazioni predefinite.

Per altre informazioni, vedere Informazioni sulle impostazioni client.

RESETKEYINFORMATION

Se un client ha la chiave radice attendibile Configuration Manager errata, non può contattare un punto di gestione attendibile per ricevere la nuova chiave radice attendibile. Utilizzare questa proprietà per rimuovere la chiave radice attendibile precedente. Questa situazione può verificarsi quando si sposta un client da una gerarchia del sito a un'altra. Questa proprietà si applica ai client che usano la comunicazione client HTTP e HTTPS. Per altre informazioni, vedere Pianificazione della chiave radice attendibile.

Esempio: CCMSetup.exe RESETKEYINFORMATION=TRUE

SITEREASSIGN

Abilita la riassegnazione automatica del sito per gli aggiornamenti client se usato con SMSSITECODE=AUTO.

Esempio: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE

SMSCACHEDIR

Specifica il percorso della cartella della cache client nel computer client. Per impostazione predefinita, il percorso della cache è %WinDir%\ccmcache.

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

Utilizzare questa proprietà con la SMSCACHEFLAGS proprietà per controllare il percorso della cartella della cache client. Ad esempio, per installare la cartella cache client nell'unità disco client più grande disponibile: CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE

SMSCACHEFLAGS

Utilizzare questa proprietà per specificare ulteriori dettagli di installazione per la cartella della cache client. È possibile usare SMSCACHEFLAGS le proprietà singolarmente o in combinazione separate da punti e virgola (;).

Se non si include questa proprietà:

  • Il client installa la cartella cache in base alla SMSCACHEDIR proprietà
  • La cartella non è compressa
  • Il client usa la SMSCACHESIZE proprietà come limite di dimensioni in MB della cache

Quando si aggiorna un client esistente, il programma di installazione client ignora questa proprietà.

Valori per la SMSCACHEFLAGS proprietà

  • PERCENTDISKSPACE: impostare le dimensioni della cache come percentuale dello spazio totale su disco. Se si specifica questa proprietà, impostare anche su SMSCACHESIZE un valore percentuale.

  • PERCENTFREEDISKSPACE: impostare le dimensioni della cache come percentuale dello spazio disponibile su disco. Se si specifica questa proprietà, impostare SMSCACHESIZE anche come valore percentuale. Ad esempio, il disco ha 10 MB di spazio libero e si specifica SMSCACHESIZE=50. Il programma di installazione client imposta le dimensioni della cache su 5 MB. Non è possibile usare questa proprietà con la PERCENTDISKSPACE proprietà .

  • MAXDRIVE: installare la cache nel disco più grande disponibile. Se si specifica un percorso con la SMSCACHEDIR proprietà , il programma di installazione client ignora questo valore.

  • MAXDRIVESPACE: installare la cache nell'unità disco con lo spazio disponibile maggiore. Se si specifica un percorso con la SMSCACHEDIR proprietà , il programma di installazione client ignora questo valore.

  • NTFSONLY: installare la cache solo in un'unità disco in formato NTFS. Se si specifica un percorso con la SMSCACHEDIR proprietà , il programma di installazione client ignora questo valore.

  • COMPRESS: archiviare la cache in un formato compresso.

  • FAILIFNOSPACE: se non è disponibile spazio sufficiente per installare la cache, rimuovere il client Configuration Manager.

Esempio: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

Importante

Le impostazioni client sono disponibili per specificare le dimensioni della cartella della cache client. L'aggiunta di tali impostazioni client sostituisce in modo efficace l'uso di SMSCACHESIZE come proprietà client.msi per specificare le dimensioni della cache client. Per altre informazioni, vedere le impostazioni client per le dimensioni della cache.

Quando si aggiorna un client esistente, il programma di installazione client ignora questa impostazione. Il client ignora anche le dimensioni della cache quando scarica gli aggiornamenti software.

Esempio: CCMSetup.exe SMSCACHESIZE=100

Nota

Se si reinstalla un client, non è possibile usare SMSCACHESIZE o SMSCACHEFLAGS impostare le dimensioni della cache su dimensioni inferiori rispetto a quelle precedenti. La dimensione precedente è il valore minimo.

SMSCONFIGSOURCE

Utilizzare questa proprietà per specificare la posizione e l'ordine in cui il programma di installazione client controlla le impostazioni di configurazione. Si tratta di una stringa di uno o più caratteri, ognuno dei quali definisce un'origine di configurazione specifica:

  • R: verificare la presenza di impostazioni di configurazione nel Registro di sistema.

    Per altre informazioni, vedere Effettuare il provisioning delle proprietà di installazione client.

  • P: controllare le impostazioni di configurazione nelle proprietà di installazione dalla riga di comando.

  • M: controllare le impostazioni esistenti quando si aggiorna un client meno recente.

  • U: aggiornare il client installato a una versione più recente e usare il codice del sito assegnato.

Per impostazione predefinita, il programma di installazione client usa PU. Prima controlla le proprietà di installazione (P) e quindi le impostazioni esistenti (U).

Esempio: CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMP

Specifica un punto di gestione iniziale da usare per il client Configuration Manager.

Importante

Se il punto di gestione accetta solo connessioni client tramite HTTPS, anteporre al nome del punto di https://gestione .

Esempi:

  • CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSMPLIST

Specifica un elenco di punti di gestione da usare per il client Configuration Manager. Usare un punto e virgola (;) come delimitatore quando si specificano più punti di gestione.

Importante

Se il punto di gestione accetta solo connessioni client tramite HTTPS, anteporre al nome del punto di https://gestione .

Esempi:

  • 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

Se il client non riesce a ottenere il Configuration Manager chiave radice attendibile da Active Directory Domain Services, usare questa proprietà per specificare la chiave. Questa proprietà si applica ai client che usano la comunicazione HTTP e HTTPS. Per altre informazioni, vedere Pianificazione della chiave radice attendibile.

Esempio: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

Consiglio

Ottenere il valore per la chiave radice attendibile del sito dal file mobileclient.tcf nel server del sito. Per altre informazioni, vedere Pre-provisioning di un client con la chiave radice attendibile usando un file.

SMSROOTKEYPATH

Utilizzare questa proprietà per reinstallare la chiave radice attendibile Configuration Manager. Specifica il percorso completo e il nome di un file che contiene la chiave radice attendibile. Questa proprietà si applica ai client che usano la comunicazione client HTTP e HTTPS. Per altre informazioni, vedere Pianificazione della chiave radice attendibile.

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

SMSSIGNCERT

Specifica il percorso completo e il nome del certificato autofirma esportato nel server del sito. Il server del sito archivia questo certificato nell'archivio certificati SMS . Ha il nome soggetto Server del sito e il nome descrittivo Certificato di firma del server del sito.

Esportare il certificato senza la chiave privata, archiviare il file in modo sicuro e accederle solo da un canale protetto.

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

SMSSITECODE

Questa proprietà specifica un sito Configuration Manager a cui assegnare il client. Questo valore può essere un codice del sito a tre caratteri o la parola AUTO. Se si specifica AUTOo non si specifica questa proprietà, il client tenta di determinare l'assegnazione del sito da Active Directory Domain Services o da un punto di gestione specificato. Per abilitare AUTO gli aggiornamenti client, impostare anche SITEREASSIGN=TRUE.

Nota

Se si specifica anche un punto di gestione basato su Internet con la CCMHOSTNAME proprietà , non usare AUTO con SMSSITECODE. Assegnare direttamente il client al sito specificando il codice del sito.

Esempio: CCMSetup.exe SMSSITECODE=XZY

UPGRADETOLATEST

Questa proprietà impone a CCMSetup di inviare una richiesta di posizione al punto di gestione per ottenere la versione più recente dell'origine di installazione client Configuration Manager. Esistono diversi scenari in cui questa proprietà è particolarmente utile:

  • Client di pre-produzione. Un client appena installato usa la baseline di produzione perché non può valutare la raccolta di pre-produzione fino a quando il client non viene installato. In questo scenario, dopo l'installazione del client e la valutazione dei criteri, verrà eseguito l'aggiornamento alla versione client di pre-produzione. Utilizzare questa proprietà in modo che il dispositivo installi immediatamente la versione più recente del client.

    Questo scenario include anche quando si usa Autopilot nella co-gestione. Utilizzare questa proprietà per assicurarsi che il dispositivo Autopilot di cui è stato appena effettuato il provisioning usi immediatamente la versione client di pre-produzione.

  • Punti di distribuzione pull. Consenti ai punti di distribuzione pull di installare la versione client più recente anche se non è presente nella raccolta di pre-produzione. Questa azione garantisce che la versione client nel punto di distribuzione pull sia uguale ai file binari dei punti di distribuzione. Se queste versioni non sono uguali, potrebbero verificarsi problemi.

Valori degli attributi per i criteri di selezione del certificato

Configuration Manager supporta i valori di attributo seguenti per i criteri di selezione del certificato PKI:

Attributo OID Attributo Distinguished Name Definizione dell'attributo
0.9.2342.19200300.100.1.25 DC Componente dominio
1.2.840.113549.1.9.1 Posta elettronica o posta elettronica Indirizzo di posta elettronica
2.5.4.3 CN Nome comune
2.5.4.4 SN Nome soggetto
2.5.4.5 SERIALNUMBER Numero di serie
2.5.4.6 C Codice paese
2.5.4.7 L Località
2.5.4.8 S o ST Nome dello stato o della provincia
2.5.4.9 VIA Indirizzo
2.5.4.10 O Nome dell'organizzazione
2.5.4.11 OU Unità organizzativa
2.5.4.12 T o Titolo Titolo
2.5.4.42 G, GN o GivenName Nome specificato
2.5.4.43 I o Iniziali Iniziali
2.5.29.17 (nessun valore) Nome alternativo soggetto

Installazione push client

Se si usa il metodo di installazione push client, utilizzare le opzioni seguenti nella scheda Client delle proprietà di installazione push client nella console di Configuration Manager: