Informazioni sui parametri e le proprietà di installazione del client in Gestione configurazione

Si applica a: Gestione configurazione (Current Branch)

Usare il comando CCMSetup.exe per installare il client Gestione configurazione. Se si specificano parametri di installazione client nella riga di comando, essi modificano il comportamento di installazione. Se si specificano le proprietà di installazione del client nella riga di comando, esse 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 di Gestione configurazione

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

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

CCMSetup.exe e i file di supporto si trovano nel server del sito, nella cartella Client della cartella di installazione Gestione configurazione. Gestione configurazione condivide questa cartella con la 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

In questo esempio vengono eseguite le operazioni seguenti:

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

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

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

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

Se si estende lo schema Active Directory per Gestione configurazione, il sito pubblica molte proprietà di installazione client in Active Directory Domain Services. Il client di Gestione configurazione legge automaticamente queste proprietà. Per ulteriori 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, viene scaricato il contenuto, eseguito la registrazione nel sito e il criterio iniziale viene scaricato. Qualsiasi ulteriore comunicazione con il client segue la configurazione delle impostazioni client da tale criterio. Per ulteriori informazioni, vedere Informazioni sulle impostazioni client.

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

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à l'aggiornamento automatico quando si abilita l'aggiornamento automatico del client.

Valori supportati:

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

Ad esempio:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

Per ulteriori informazioni, vedere Client di interoperabilità estesa.

/BITSPriority

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

• 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 del client.

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

• Se specifichi il /noservice parametro, inserisci questo file nella stessa cartella di CCMSetup.exe.

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

Per fornire il formato file corretto, usare il file mobileclienttemplate.tcf nella \bin\<platform> cartella nella directory di installazione di Gestione configurazione nel server di sito. Questo file contiene commenti sulle sezioni e su come usarle. Specificare le proprietà di installazione del 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 download dei file di installazione. Il valore predefinito è 1440 minuti (un giorno).

Usare il /retry parametro per specificare l'intervallo tra i tentativi.

Esempio: ccmsetup.exe /downloadtimeout:100

/ExcludeFeatures

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

Esempio: CCMSetup.exe /ExcludeFeatures:ClientUI Software Center non viene installato sul client.

/forceinstall

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

/forcereboot

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

Esempio: CCMSetup.exe /forcereboot

/logon

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

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 del 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 su come ccmsetup scarica il contenuto, vedere Gruppi di limiti - Installazione client. L'articolo include anche dettagli sul comportamento di ccmsetup se si usano entrambi /mp e /source i parametri.

I computer scaricano i file tramite una connessione HTTP o HTTPS, a seconda della configurazione del ruolo di sistema del sito per le connessioni client. Il download può anche usare la limitazione BITS se configurata. Se si configurano tutti i punti di distribuzione e i punti di gestione solo per 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ù di un punto di gestione. Se il computer non riesce a connettersi alla prima, prova la successiva nell'elenco specificato. Se si specificano più punti di gestione, separare i valori con punti e virgola.

Se il client si connette a un punto di gestione tramite HTTPS, specificare il nome di dominio completo anziché il nome del computer. Il valore deve corrispondere all'oggetto o al nome alternativo del soggetto del certificato PKI del punto di gestione. Anche se Gestione configurazione supporta l'uso di un nome computer nel certificato per le connessioni nella rete Intranet, è consigliabile usare un FQDN.

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

Esempio con FQDN: ccmsetup.exe /mp:smsmp01.contoso.com

Questo parametro può anche specificare l'URL di un gateway di gestione cloud (CMG). Usare questo URL per installare il client in un dispositivo basato su Internet. Per ottenere il valore per questo parametro, eseguire la procedura seguente:

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

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

• Eseguire il comando qui riportato:

  (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 di uso dell'URL del gateway di gestione cloud: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

/NoCRLCheck

Specifica che un client non deve controllare l'elenco di revoche di certificati (CRL) quando comunica tramite HTTPS con un certificato PKI. Se non si specifica questo parametro, il client controlla il CRL prima di stabilire una connessione HTTPS. Per altre informazioni sul controllo dei CRL client, vedere Pianificazione della revoca del certificato PKI.

Esempio: CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

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

Esempio: ccmsetup.exe /noservice

/regtoken

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

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

• /mp
• CCMHOSTNAME
• SMSSITECODE
• SMSMP

La seguente riga di comando di esempio include gli altri parametri e proprietà di configurazione richiesti:

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

/retry

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 ripetere i tentativi finché non raggiunge il /downloadtimeout limite specificato nel parametro.

Esempio: ccmsetup.exe /retry:20

/service

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

Esempio: ccmsetup.exe /service

/skipprereq

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

Esempi:

• CCMSetup.exe /skipprereq:filename.exe

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

Per ulteriori informazioni sui prerequisiti client, vedere Prerequisiti 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 utilizzare /source, l'account utente di Windows per l'installazione client richiede autorizzazioni di lettura per il percorso.

Per altre informazioni su come ccmsetup scarica il contenuto, vedere Gruppi di limiti - Installazione client. L'articolo include anche dettagli sul comportamento di ccmsetup se si usano entrambi /mp e /source i parametri.

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

/uninstall

Usare questo parametro per disinstallare il client di Gestione configurazione. Per ulteriori informazioni, vedere Disinstallare il client.

Esempio: ccmsetup.exe /uninstall

/UsePKICert

Specifica questo parametro per il client per l'uso di un certificato di autenticazione client PKI. Se non si include questo parametro o se il client non riesce a trovare un certificato valido, esso filtra tutti i punti di gestione HTTPS, inclusi i gateway di gestione cloud (CMG). Il client utilizza una connessione HTTP con un certificato autofirmato.

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 Includi questo parametro il client non sarà in grado di ottenere le informazioni di onboarding di Microsoft Entra da un gateway di gestione cloud (CMG). Per un client che usa l'autenticazione Microsoft Entra, non specificare questo parametro, ma includere le proprietà AADRESOURCEURI e AADCLIENTAPPID.

/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 la risoluzione dei problemi, esamina %WinDir%\ccmsetup\Logs\ccmsetup.log il client per il contesto e altri dettagli sui codici restituiti.

Ccmsetup.msi proprietà

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

CCMSETUPCMD

Usa questo ccmsetup. per passare proprietà e parametri della riga di comando aggiuntivi a CCMSETUP. exe. Includere altri parametri e proprietà tra virgolette ("). Usare questa proprietà quando si esegue l'avvio del client di Gestione configurazione con il metodo di installazione MDM di Intune.

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

Client.msi proprietà

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 la gestione cloud. Un amministratore di Azure può ottenere il valore per questa proprietà dal 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 la gestione cloud. Quando si crea l'applicazione server, nella finestra Crea applicazione server, questa proprietà rappresenta l'URI dell'ID app.

Un amministratore di Azure può ottenere il valore per questa proprietà dal portale di Azure. In Microsoft Entra ID trovare l'app server in Registrazioni app. Cerca il tipo di applicazione Web app / API. Apri l'app, seleziona Impostazioni, quindi seleziona Proprietà. Usare il valore URI dell'ID app per questa AADRESOURCEURI proprietà di installazione client.

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

AADTENANTID

Specifica l'identificatore del tenant di Microsoft Entra. Gestione configurazione si collega a questo tenant quando si configurano i servizi di Azure per la gestione cloud. Per ottenere il valore per questa proprietà, eseguire la procedura seguente:

• In un dispositivo che esegue Windows 10 o versione successiva e che è collegato allo stesso tenant di Microsoft Entra, aprire un prompt dei comandi.

• Esegui il comando seguente: dsregcmd.exe /status

• Nella sezione Stato dispositivo trovare il valore TenantId . Ad esempio, TenantId : aaaabbbb-0000-cccc-1111-dddd2222eeee

  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=aaaabbbb-0000-cccc-1111-dddd2222eeee

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 punto e virgola (;).

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

CCMALLOWSILENTREBOOT

Se necessario, consentire il riavvio automatico del computer dopo l'installazione del client.

Esempio: CCMSetup.exe CCMALLOWSILENTREBOOT

CCMALWAYSINF

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

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

Per ulteriori informazioni sulla gestione dei client basata su Internet, vedere Considerazioni per le comunicazioni client da Internet o da una foresta non attendibile.

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

CCMCERTISSUERS

Usare questa proprietà per specificare l'elenco delle autorità di certificazione esistenti. Questo elenco include informazioni sui certificati per le autorità di certificazione radice attendibili (CA) considerate attendibili dal sito di Gestione configurazione.

Questo valore è una corrispondenza con distinzione tra maiuscole e minuscole per gli attributi dell'oggetto presenti nel certificato CA radice. Separare gli attributi con una virgola (,) o un punto e virgola (;). Specificare più certificati CA radice usando una barra di separazione (|).

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

Per ulteriori informazioni sull'elenco delle autorità emittenti di certificati e su come i client lo utilizzano durante il processo di selezione dei certificati, vedere Pianificazione della selezione dei certificati client PKI.

CCMCERTNAMECHECK

A partire dalla versione 2207, questa proprietà può essere usata per ignorare il controllo del nome del soggetto per il certificato. CCMCERTNAMECHECK=0 Salta il controllo del nome dell'oggetto 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.

Per cercare il nome dell'oggetto del certificato o il nome alternativo dell'oggetto, usa le parole chiave seguenti:

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

Esempi:

• CCMCERTSEL="Subject:computer1.contoso.com": consente di cercare un certificato con una corrispondenza esatta al nome computer1.contoso.com del computer in Nome soggetto o Nome alternativo oggetto.

• CCMCERTSEL="SubjectStr:contoso.com": consente di cercare un certificato che contiene contoso.com il nome dell'oggetto o il nome alternativo dell'oggetto.

Utilizzare la SubjectAttr parola chiave per cercare gli attributi Identificatore oggetto (OID) o nome distinto in Nome soggetto o Nome alternativo soggetto.

Esempi:

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

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

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

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

CCMCERTSTORE

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

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

CCMDEBUGLOGGING

Questa proprietà abilita la registrazione di debug all'installazione del client. Questa proprietà fa sì che il client registri informazioni di basso livello per la risoluzione dei problemi. Evitare di usare questa proprietà nei siti di produzione. Potrebbe verificarsi una registrazione eccessiva, che potrebbe rendere difficile trovare informazioni pertinenti nei file di log. Abilita anche CCMENABLELOGGING.

Valori supportati:

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

Esempio: CCMSetup.exe CCMDEBUGLOGGING=1

Per altre informazioni, vedere Informazioni sui file di log.

CCMENABLELOGGING

Gestione configurazione abilita la registrazione per impostazione predefinita.

Valori supportati:

• TRUE: attiva 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 di esecuzione dello strumento di valutazione dell'integrità del client (ccmeval.exe). Specificare un valore intero tra 1 e 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à dei 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à dei client, vedere Monitorare i client.

CCMFIRSTCERT

Se si imposta questa proprietà su 1, 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 specificate questa opzione con la proprietà di installazione di SMSSITECODE=AUTO. Assegnare direttamente 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 (CMG). Per ottenere il valore per questa proprietà, eseguire la procedura seguente:

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

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

• Eseguire il comando qui riportato:

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

• Usare il valore restituito così com'è con la CCMHOSTNAME proprietà.

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

CCMHTTPPORT

Specifica la porta che il client deve usare quando comunica tramite HTTP con i 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 con i server del sistema del sito. Per impostazione predefinita, questo valore è 443.

Esempio: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

Usare questa proprietà per impostare la cartella in cui installare i file client di Gestione configurazione. Per impostazione predefinita, usa %WinDir%\CCM.

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

CCMLOGLEVEL

Usare questa proprietà per specificare il livello di dettaglio da scrivere nei file di log di Gestione configurazione.

Valori supportati:

• 0: Verbose
• 1: impostazione predefinita
• 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 di Gestione configurazione 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 conservare. Il valore predefinito è 1. Se si imposta il valore su 0, il client non mantiene la cronologia dei file di registro.

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 tronco 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

Imposta questa proprietà su TRUE per impedire agli amministratori di modificare il sito assegnato nel pannello di controllo di Gestione configurazione.

Esempio: CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

Se impostata su TRUE, questa proprietà impedisce agli utenti amministratori di modificare le impostazioni della cartella della cache del client nel Pannello di controllo di Gestione configurazione.

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, fornisce al client informazioni sugli altri punti di gestione nella gerarchia. Questo comportamento indica che il punto di gestione che il client trova dal DNS può essere uno qualsiasi nella gerarchia.

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

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

FSP

Specifica il punto di stato di fallback che riceve ed elabora i messaggi di stato inviati dai client di Gestione configurazione.

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

Esempio: CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

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

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, vedi Consentire automaticamente le app distribuite da un programma di installazione gestito con Controllo applicazioni di Windows Defender.

Esempio: CCMSetup.exe MANAGEDINSTALLER=1

NOTIFYONLY

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

Esempio: CCMSetup.exe NOTIFYONLY=TRUE

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

PROVISIONTS

Usare questa proprietà per avviare una sequenza di attività in un client dopo che è stato registrato correttamente nel sito.

Ad esempio, è necessario eseguire il provisioning di un nuovo dispositivo Windows con Windows Autopilot, registrarlo automaticamente in Microsoft Intune e quindi installare il client di Gestione configurazione per la co-gestione. Se si specifica questa nuova opzione, il client di cui è appena stato eseguito il provisioning esegue una sequenza di attività. Questo processo offre una flessibilità aggiuntiva per installare applicazioni e aggiornamenti software o configurare le impostazioni.

Usa la procedura seguente:

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

2. Distribuire questa sequenza di attività nella nuova raccolta predefinita, Tutti i dispositivi di provisioning. Prendere nota dell'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 distribuzione come valore della proprietà, lo scopo non è importante.

3. Installare il client Gestione configurazione in un dispositivo che utilizza ccmsetup.msie includere la proprietà seguente: PROVISIONTS=PRI20001. Imposta il valore di questa proprietà come ID 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 in Microsoft Entra ID o la creazione di un gateway di gestione cloud abilitato per i contenuti.

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

Dopo l'installazione e la corretta registrazione del client nel sito, viene avviata la sequenza di attività a cui si fa riferimento. Se la registrazione del client non riesce, la sequenza di attività non viene avviata.

RESETKEYINFORMATION

Se un client dispone della chiave radice attendibile di Gestione configurazione errata, non può contattare un punto di gestione attendibile per ricevere la nuova chiave radice attendibile. Usare questa proprietà per rimuovere la vecchia chiave radice attendibile. Questa situazione può verificarsi quando si sposta un client da una gerarchia di siti a un'altra. Questa proprietà si applica ai client che utilizzano 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 del client se usato con SMSSITECODE=AUTO.

Esempio: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE

SMSCACHEDIR

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

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

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

SMSCACHEFLAGS

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

Se non si include questa proprietà:

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

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

Valori per la SMSCACHEFLAGS proprietà

• PERCENTDISKSPACE: imposta la dimensione della cache come percentuale dello spazio totale su disco. Se si specifica questa proprietà, impostarla SMSCACHESIZE anche su un valore percentuale.

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

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

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

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

• COMPRESS: archiviare la cache in un formato compresso.

• FAILIFNOSPACE: se lo spazio non è sufficiente per installare la cache, rimuovi il client di Gestione configurazione.

Esempio: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

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

Esempio: CCMSetup.exe SMSCACHESIZE=100

SMSCONFIGSOURCE

Usare questa proprietà per specificare il percorso 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: controlla le impostazioni di configurazione nel Registro di sistema.

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

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

• M: controlla la presenza di impostazioni esistenti quando aggiorni un client precedente.

• U: aggiorna il client installato a una versione più recente e usa il codice sito assegnato.

Per impostazione predefinita, il programma di installazione del client utilizza PU. Controlla prima le proprietà di installazione (P) e quindi le impostazioni esistenti (U).

Esempio: CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMP

Specifica un punto di gestione iniziale per l'uso da parte del client di Gestione configurazione.

Esempi:

• CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSMPLIST

Specifica un elenco di punti di gestione per il client di Gestione configurazione da usare. Usare un punto e virgola (;) come delimitatore quando si specificano più punti di 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 la chiave radice attendibile di Gestione configurazione da Active Directory Domain Services, usa questa proprietà per specificare la chiave. Questa proprietà si applica ai client che utilizzano la comunicazione HTTP e HTTPS. Per altre informazioni, vedere Pianificazione della chiave radice attendibile.

Esempio: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

SMSROOTKEYPATH

Usare questa proprietà per reinstallare la chiave radice attendibile di Gestione configurazione. Specifica il percorso completo e il nome di un file che contiene la chiave radice attendibile. Questa proprietà si applica ai client che utilizzano 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 autofirmato esportato nel server di 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 accedervi solo da un canale protetto.

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

SMSSITECODE

Questa proprietà specifica un sito di Gestione configurazione a cui si assegna il client. Questo valore può essere un codice del sito di 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 anche gli aggiornamenti del client, impostare SITEREASSIGN=TRUE.

Esempio: CCMSetup.exe SMSSITECODE=XZY

UPGRADETOLATEST

Questa proprietà forza CCMSetup a inviare una richiesta di posizione al punto di gestione per ottenere la versione più recente dell'origine di installazione del client Gestione configurazione. 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 che il client è stato installato e ha valutato i criteri, verrà eseguito l'aggiornamento alla versione client di pre-produzione. Usare questa proprietà per consentire al dispositivo di installare immediatamente la versione più recente del client.

  Questo scenario include anche l'uso di Windows Autopilot nella co-gestione. Usare questa proprietà per assicurarsi che il dispositivo Windows Autopilot di cui è appena stato eseguito il provisioning usi immediatamente la versione client di pre-produzione.

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

Valori degli attributi per i criteri di selezione dei certificati

Gestione configurazione supporta i valori di attributo seguenti per i criteri di selezione del certificato PKI:

Installazione push client

Se si utilizza il metodo di installazione push client, utilizzare le opzioni seguenti nella scheda Client delle Proprietà installazione push client nella console di Gestione configurazione:

• Proprietà Client.msi

• Per il push del client è consentito il sottoinsieme seguente di CCMSetup.exe parametri della riga di comando :

  • /AllowMetered (a partire dalla versione 2103)

  • /AlwaysExcludeUpgrade

  • /BITSPriority

  • /downloadtimeout

  • /ExcludeFeatures

  • /forcereboot

  • /logon

  • /skipprereq

  • /UsePKICert