À propos des paramètres et propriétés d’installation du client dans Configuration Manager

S’applique à : Configuration Manager (branche actuelle)

Utilisez la commande CCMSetup.exe pour installer le client Configuration Manager. Si vous fournissez des paramètres d’installation du client sur la ligne de commande, ils modifient le comportement d’installation. Si vous fournissez des propriétés d’installation du client sur la ligne de commande, elles modifient la configuration initiale de l’agent client installé.

À propos de CCMSetup.exe

La commande CCMSetup.exe télécharge les fichiers nécessaires pour installer le client à partir d’un point de gestion ou d’un emplacement source. Ces fichiers peuvent inclure :

• Le package Windows Installer client.msi qui installe le logiciel client

• Conditions préalables du client

• Mises à jour et correctifs pour le client Configuration Manager

CCMSetup.exe fournit des paramètres de ligne de commande pour personnaliser l’installation. Les paramètres sont précédés d’une barre oblique (/) et sont généralement en minuscules. Vous spécifiez la valeur d’un paramètre si nécessaire à l’aide d’un signe deux-points (:) immédiatement suivi de la valeur . Pour plus d’informations, consultez CCMSetup.exe paramètres de ligne de commande.

Vous pouvez également fournir des propriétés sur la ligne de commande CCMSetup.exe pour modifier le comportement de client.msi. Les propriétés par convention sont en majuscules. Vous spécifiez une valeur pour une propriété à l’aide d’un signe égal (=) immédiatement suivi de la valeur. Pour plus d’informations, consultez propriétésClient.msi.

CCMSetup.exe et les fichiers de prise en charge se trouvent sur le serveur de site dans le dossier Client du dossier d’installation Configuration Manager. Configuration Manager partage ce dossier sur le réseau sous le partage de site. Par exemple : \\SiteServer\SMS_ABC\Client.

À l’invite de commandes, la commande CCMSetup.exe utilise le format suivant :

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

Par exemple :

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

Cet exemple effectue les opérations suivantes :

• Spécifie le point de gestion nommé SMSMP01 demander une liste de points de distribution pour télécharger les fichiers d’installation du client.

• Spécifie que l’installation doit s’arrêter si une version du client existe déjà sur l’ordinateur.

• Indique client.msi d’affecter le client au code de site S01.

• Indique client.msi d’utiliser le point de status de secours nommé SMSFP01.

Si vous étendez le schéma Active Directory pour Configuration Manager, le site publie de nombreuses propriétés d’installation du client dans services de domaine Active Directory. Le client Configuration Manager lit automatiquement ces propriétés. Pour plus d’informations, consultez À propos des propriétés d’installation du client publiées sur services de domaine Active Directory

CCMSetup.exe paramètres de ligne de commande

/?

Affiche les paramètres de ligne de commande disponibles pour ccmsetup.exe.

Exemple : ccmsetup.exe /?

/AllowMetered

Utilisez ce paramètre pour contrôler le comportement du client sur un réseau limité. Ce paramètre ne prend aucune valeur. Lorsque vous autorisez la communication cliente sur un réseau limité pour ccmsetup, il télécharge le contenu, s’inscrit auprès du site et télécharge la stratégie initiale. Toute autre communication client suit la configuration du paramètre client à partir de cette stratégie. Pour plus d’informations, consultez À propos des paramètres client.

Si vous réinstallez le client sur un appareil existant, il utilise la priorité suivante pour déterminer sa configuration :

1. Stratégie cliente locale existante
2. Dernière ligne de commande stockée dans le Registre Windows
3. Paramètres sur la ligne de commande ccmsetup

/AlwaysExcludeUpgrade

Ce paramètre spécifie si un client est automatiquement mis à niveau lorsque vous activez la mise à niveau automatique du client.

Valeurs prises en charge :

• TRUE: le client ne met pas automatiquement à niveau
• FALSE: le client effectue automatiquement une mise à niveau (par défaut)

Par exemple :

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

Pour plus d’informations, consultez Client d’interopérabilité étendue.

/BITSPriority

Lorsque l’appareil télécharge les fichiers d’installation du client via une connexion HTTP, utilisez ce paramètre pour spécifier la priorité de téléchargement. Spécifiez l’une des valeurs possibles suivantes :

• FOREGROUND

• HIGH

• NORMAL (par défaut)

• LOW

Exemple : ccmsetup.exe /BITSPriority:HIGH

/config

Ce paramètre spécifie un fichier texte qui répertorie les propriétés d’installation du client.

• Si CCMSetup s’exécute en tant que service, placez ce fichier dans le dossier système CCMSetup : %Windir%\Ccmsetup.

• Si vous spécifiez le /noservice paramètre , placez ce fichier dans le même dossier que CCMSetup.exe.

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

Pour fournir le format de fichier correct, utilisez le fichier mobileclienttemplate.tcf dans le \bin\<platform> dossier du répertoire d’installation Configuration Manager sur le serveur de site. Ce fichier contient des commentaires sur les sections et leur utilisation. Spécifiez les propriétés d’installation du client dans la [Client Install] section, après le texte suivant : Install=INSTALL=ALL.

Exemple d’entrée [Client Install] de section : Install=INSTALL=ALL SMSSITECODE=ABC SMSCACHESIZE=100

/downloadtimeout

Si CCMSetup ne parvient pas à télécharger les fichiers d’installation du client, ce paramètre spécifie le délai d’expiration maximal en minutes. Après ce délai d’expiration, CCMSetup cesse de télécharger les fichiers d’installation. La valeur par défaut est 1440 minutes (un jour).

Utilisez le /retry paramètre pour spécifier l’intervalle entre les nouvelles tentatives.

Exemple : ccmsetup.exe /downloadtimeout:100

/ExcludeFeatures

Ce paramètre spécifie que CCMSetup.exe n’installe pas la fonctionnalité spécifiée.

Exemple : CCMSetup.exe /ExcludeFeatures:ClientUI n’installe pas le Centre logiciel sur le client.

/forceinstall

Spécifiez que CCMSetup.exe désinstalle tout client existant et installe un nouveau client.

/forcereboot

Utilisez ce paramètre pour forcer l’ordinateur à redémarrer si nécessaire pour terminer l’installation. Si vous ne spécifiez pas ce paramètre, CCMSetup se ferme lorsqu’un redémarrage est nécessaire. Il continue ensuite après le redémarrage manuel suivant.

Exemple : CCMSetup.exe /forcereboot

/logon

Si une version du client est déjà installée, ce paramètre spécifie que l’installation du client doit s’arrêter.

Exemple : ccmsetup.exe /logon

/mp

Spécifie un point de gestion que les clients doivent utiliser pour rechercher le point de distribution le plus proche pour les fichiers d’installation du client. S’il n’y a aucun point de distribution ou si les ordinateurs ne peuvent pas télécharger les fichiers à partir des points de distribution au bout de quatre heures, ils téléchargent les fichiers à partir du point de gestion spécifié.

Pour plus d’informations sur la façon dont ccmsetup télécharge le contenu, consultez Groupes de limites - Installation du client. Cet article inclut également des détails sur le comportement de ccmsetup si vous utilisez à la fois les /mp paramètres et /source .

Les ordinateurs téléchargent les fichiers via une connexion HTTP ou HTTPS, en fonction de la configuration du rôle de système de site pour les connexions clientes. Le téléchargement peut également utiliser la limitation BITS si vous le configurez. Si vous configurez tous les points de distribution et points de gestion pour les connexions clientES HTTPS uniquement, vérifiez que l’ordinateur client dispose d’un certificat client valide.

Vous pouvez utiliser le /mp paramètre de ligne de commande pour spécifier plusieurs points de gestion. Si l’ordinateur ne parvient pas à se connecter au premier, il tente le suivant dans la liste spécifiée. Lorsque vous spécifiez plusieurs points de gestion, séparez les valeurs par des points-virgules.

Si le client se connecte à un point de gestion à l’aide du protocole HTTPS, spécifiez le nom de domaine complet et non le nom de l’ordinateur. La valeur doit correspondre au nom de l’objet ou de l’objet du certificat PKI du point de gestion. Bien que Configuration Manager prenne en charge l’utilisation d’un nom d’ordinateur dans le certificat pour les connexions sur l’intranet, l’utilisation d’un nom de domaine complet est recommandée.

Exemple avec le nom de l’ordinateur : ccmsetup.exe /mp:SMSMP01

Exemple avec le nom de domaine complet : ccmsetup.exe /mp:smsmp01.contoso.com

Ce paramètre peut également spécifier l’URL d’une passerelle de gestion cloud (CMG). Utilisez cette URL pour installer le client sur un appareil Internet. Pour obtenir la valeur de ce paramètre, procédez comme suit :

• Créez une passerelle de gestion cloud. Pour plus d’informations, consultez Configurer une passerelle de gestion cloud.

• Sur un client actif, ouvrez une invite de commandes Windows PowerShell en tant qu’administrateur.

• Exécutez la commande suivante :

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

• Ajoutez le https:// préfixe à utiliser avec le /mp paramètre .

Exemple lorsque vous utilisez l’URL de la passerelle de gestion cloud : ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

/NoCRLCheck

Spécifie qu’un client ne doit pas case activée la liste de révocation de certificats (CRL) lorsqu’il communique via HTTPS avec un certificat PKI. Lorsque vous ne spécifiez pas ce paramètre, le client vérifie la liste de révocation de certificats avant d’établir une connexion HTTPS. Pour plus d’informations sur la vérification de la liste de révocation de certificats cliente, consultez Planification de la révocation de certificats PKI.

Exemple : CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

Ce paramètre empêche CCMSetup de s’exécuter en tant que service, ce qu’il fait par défaut. Lorsque CCMSetup s’exécute en tant que service, il s’exécute dans le contexte du compte système local de l’ordinateur. Ce compte peut ne pas disposer des droits suffisants pour accéder aux ressources réseau requises pour l’installation. Avec /noservice, CCMSetup.exe s’exécute dans le contexte du compte d’utilisateur que vous utilisez pour démarrer l’installation.

Exemple : ccmsetup.exe /noservice

/regtoken

Utilisez ce paramètre pour fournir un jeton d’inscription en bloc. Un appareil basé sur Internet utilise ce jeton dans le processus d’inscription via une passerelle de gestion cloud (CMG). Pour plus d’informations, consultez Authentification basée sur les jetons pour la passerelle de gestion cloud.

Lorsque vous utilisez ce paramètre, incluez également les paramètres et propriétés suivants :

• /mp
• CCMHOSTNAME
• SMSSITECODE
• SMSMP

L’exemple de ligne de commande suivant inclut les autres paramètres et propriétés d’installation requis :

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

Si CCMSetup.exe ne parvient pas à télécharger les fichiers d’installation, utilisez ce paramètre pour spécifier l’intervalle de nouvelles tentatives en minutes. CCMSetup continue à réessayer jusqu’à ce qu’il atteigne la limite spécifiée dans le /downloadtimeout paramètre .

Exemple : ccmsetup.exe /retry:20

/service

Spécifie que CCMSetup doit s’exécuter en tant que service qui utilise le compte Système local.

Exemple : ccmsetup.exe /service

/skipprereq

Ce paramètre spécifie que CCMSetup.exe n’installe pas le prérequis spécifié. Vous pouvez entrer plusieurs valeurs. Utilisez le point-virgule (;) pour séparer chaque valeur.

Exemples :

• CCMSetup.exe /skipprereq:filename.exe

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

Pour plus d’informations sur les prérequis du client, consultez Conditions préalables du client Windows.

/source

Spécifie l’emplacement de téléchargement du fichier. Utilisez un chemin local ou UNC. L’appareil télécharge les fichiers à l’aide du protocole SMB (Server Message Block). Pour utiliser /source, le compte d’utilisateur Windows pour l’installation du client a besoin d’autorisations de lecture sur l’emplacement.

Pour plus d’informations sur la façon dont ccmsetup télécharge le contenu, consultez Groupes de limites - Installation du client. Cet article inclut également des détails sur le comportement de ccmsetup si vous utilisez à la fois les /mp paramètres et /source .

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

/uninstall

Utilisez ce paramètre pour désinstaller le client Configuration Manager. Pour plus d’informations, consultez Désinstaller le client.

Exemple : ccmsetup.exe /uninstall

/UsePKICert

Spécifiez ce paramètre pour que le client utilise un certificat d’authentification client PKI. Si vous n’incluez pas ce paramètre, ou si le client ne trouve pas de certificat valide, il filtre tous les points de gestion HTTPS, y compris les passerelles de gestion cloud (CMG). Le client utilise une connexion HTTP avec un certificat auto-signé.

Exemple : CCMSetup.exe /UsePKICert

Si un appareil utilise Microsoft Entra ID pour l’authentification client et dispose également d’un certificat d’authentification client basé sur une infrastructure à clé publique, si vous utilisez inclure ce paramètre, le client ne pourra pas obtenir Microsoft Entra informations d’intégration à partir d’une passerelle de gestion cloud (CMG). Pour un client qui utilise l’authentification Microsoft Entra, ne spécifiez pas ce paramètre, mais incluez les propriétés AADRESOURCEURI et AADCLIENTAPPID.

/IgnoreSkipUpgrade

Spécifiez ce paramètre pour mettre à niveau manuellement un client exclu. Pour plus d’informations, consultez Comment exclure des clients de la mise à niveau.

CCMSetup.exe codes de retour

La commande CCMSetup.exe fournit les codes de retour suivants. Pour résoudre les problèmes, examinez %WinDir%\ccmsetup\Logs\ccmsetup.log sur le client le contexte et des détails supplémentaires sur les codes de retour.

Code de retour	Signification
0	Opération réussie
6	Erreur
7	Redémarrage requis
8	Configuration déjà en cours d’exécution
9	Échec de l’évaluation des prérequis
10	Échec de validation de hachage du manifeste d’installation

Ccmsetup.msi propriétés

Les propriétés suivantes peuvent modifier le comportement d’installation de ccmsetup.msi.

CCMSETUPCMD

Utilisez ce ccmsetup. msi , propriété pour passer des paramètres de ligne de commande et des propriétés supplémentaires à ccmsetup. exe. Incluez d’autres paramètres et propriétés entre guillemets ("). Utilisez cette propriété lorsque vous démarrez le client Configuration Manager avec la méthode d’installation mdm Intune.

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

Client.msi propriétés

Les propriétés suivantes peuvent modifier le comportement d’installation de client.msi, qui ccmsetup.exe installe.

AADCLIENTAPPID

Spécifie l’identificateur de l’application cliente Microsoft Entra. Vous créez ou importez l’application cliente lorsque vous configurez les services Azure pour la gestion cloud. Un administrateur Azure peut obtenir la valeur de cette propriété à partir du Portail Azure. Pour plus d’informations, consultez Obtenir l’ID d’application. Pour la AADCLIENTAPPID propriété , cet ID d’application est pour le type d’application native .

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

AADRESOURCEURI

Spécifie l’identificateur d’application du serveur Microsoft Entra. Vous créez ou importez l’application serveur lorsque vous configurez les services Azure pour la gestion cloud. Lorsque vous créez l’application serveur, dans la fenêtre Créer une application serveur, cette propriété est l’URI ID d’application.

Un administrateur Azure peut obtenir la valeur de cette propriété à partir du Portail Azure. Dans Microsoft Entra ID, recherchez l’application serveur sous inscriptions d'applications. Recherchez le type d’application Application web/API. Ouvrez l’application, sélectionnez Paramètres, puis Propriétés. Utilisez la valeur URI ID de l’application pour cette AADRESOURCEURI propriété d’installation du client.

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

AADTENANTID

Spécifie l’identificateur de locataire Microsoft Entra. Configuration Manager des liens vers ce locataire lorsque vous configurez les services Azure pour la gestion cloud. Pour obtenir la valeur de cette propriété, procédez comme suit :

• Sur un appareil qui s’exécute Windows 10 ou une version ultérieure et qui est joint au même locataire Microsoft Entra, ouvrez une invite de commandes.

• Exécutez la commande suivante : dsregcmd.exe /status

• Dans la section État de l’appareil, recherchez la valeur TenantId . Par exemple, TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49a

  Remarque

  Un administrateur Azure peut également obtenir cette valeur dans le Portail Azure. Pour plus d’informations, consultez Obtenir l’ID de locataire.

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

CCMADMINS

Spécifie un ou plusieurs comptes d’utilisateur ou groupes d’utilisateurs Windows à accorder à l’accès aux paramètres et stratégies du client. Cette propriété est utile lorsque vous n’avez pas d’informations d’identification d’administration locales sur l’ordinateur client. Spécifiez une liste de comptes séparés par des points-virgules (;).

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

CCMALLOWSILENTREBOOT

Si nécessaire, autorisez l’ordinateur à redémarrer en mode silencieux après l’installation du client.

Exemple : CCMSetup.exe CCMALLOWSILENTREBOOT

CCMALWAYSINF

Pour spécifier que le client est toujours basé sur Internet et ne se connecte jamais à l’intranet, définissez cette valeur de propriété sur 1. Le type de connexion du client affiche Always Internet.

Utilisez cette propriété avec CCMHOSTNAME pour spécifier le nom de domaine complet du point de gestion Internet. Utilisez-la également avec le paramètre CCMSetup UsePKICert et la propriété SMSSITECODE .

Pour plus d’informations sur la gestion des clients basée sur Internet, consultez Considérations relatives aux communications client à partir d’Internet ou d’une forêt non approuvée.

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

CCMCERTISSUERS

Utilisez cette propriété pour spécifier la liste des émetteurs de certificats. Cette liste contient des informations de certificat pour les autorités de certification racines approuvées par le site Configuration Manager.

Cette valeur est une correspondance sensible à la casse pour les attributs d’objet qui se trouvent dans le certificat d’autorité de certification racine. Séparez les attributs par une virgule (,) ou un point-virgule (;). Spécifiez plusieurs certificats d’autorité de certification racine à l’aide d’une barre de séparation (|).

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

Pour plus d’informations sur la liste des émetteurs de certificats et sur la façon dont les clients l’utilisent pendant le processus de sélection de certificat, consultez Planification de la sélection des certificats clients PKI.

CCMCERTNAMECHECK

À compter de la version 2207, cette propriété peut être utilisée pour ignorer la vérification du nom de l’objet du certificat. CCMCERTNAMECHECK=0 ignore la vérification du nom d’objet du certificat.

CCMCERTSEL

Si le client dispose de plusieurs certificats pour la communication HTTPS, cette propriété spécifie les critères pour sélectionner un certificat d’authentification client valide.

Utilisez les mots clés suivants pour rechercher le nom de l’objet du certificat ou l’autre nom de l’objet :

• Subject: Rechercher une correspondance exacte
• SubjectStr: Rechercher une correspondance partielle

Exemples :

• CCMCERTSEL="Subject:computer1.contoso.com": recherchez un certificat avec une correspondance exacte avec le nom computer1.contoso.com de l’ordinateur dans le nom de l’objet ou l’autre nom de l’objet.

• CCMCERTSEL="SubjectStr:contoso.com": recherchez un certificat qui contient contoso.com dans le nom de l’objet ou l’autre nom de l’objet.

Utilisez la SubjectAttr mot clé pour rechercher l’identificateur d’objet (OID) ou les attributs de nom unique dans le nom de l’objet ou l’autre nom de l’objet.

Exemples :

• CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": recherchez l’attribut d’unité d’organisation exprimé en tant qu’identificateur d’objet et nommé Computers.

• CCMCERTSEL="SubjectAttr:OU = Computers": recherchez l’attribut d’unité d’organisation exprimé sous la forme d’un nom unique et nommé Computers.

Pour obtenir la liste complète des attributs que vous pouvez utiliser pour la sélection de certificat, consultez Valeurs d’attribut prises en charge pour les critères de sélection de certificat PKI.

Si plusieurs certificats correspondent à la recherche et que vous définissez CCMFIRSTCERT1sur , le programme d’installation du client sélectionne le certificat dont la période de validité est la plus longue.

CCMCERTSTORE

Si le programme d’installation du client ne trouve pas de certificat valide dans le magasin de certificats Personnel par défaut pour l’ordinateur, utilisez cette propriété pour spécifier un autre nom de magasin de certificats.

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

CCMDEBUGLOGGING

Cette propriété active la journalisation du débogage lors de l’installation du client. Cette propriété permet au client d’enregistrer des informations de bas niveau à des fins de résolution des problèmes. Évitez d’utiliser cette propriété dans les sites de production. Une journalisation excessive peut se produire, ce qui peut rendre difficile la recherche d’informations pertinentes dans les fichiers journaux. CCMENABLELOGGINGActivez également .

Valeurs prises en charge :

• 0: Désactiver la journalisation du débogage (par défaut)
• 1: Activer la journalisation du débogage

Exemple : CCMSetup.exe CCMDEBUGLOGGING=1

Pour plus d’informations, consultez À propos des fichiers journaux.

CCMENABLELOGGING

Configuration Manager active la journalisation par défaut.

Valeurs prises en charge :

• TRUE: Activer la journalisation (par défaut)
• FALSE: Désactiver la journalisation

Exemple : CCMSetup.exe CCMENABLELOGGING=TRUE

Pour plus d’informations, consultez À propos des fichiers journaux.

CCMEVALINTERVAL

Fréquence en minutes à laquelle l’outil d’évaluation de l’intégrité du client (ccmeval.exe) s’exécute. Spécifiez une valeur entière de 1 à 1440. Par défaut, ccmeval s’exécute une fois par jour (1 440 minutes).

Exemple : CCMSetup.exe CCMEVALINTERVAL=1440

Pour plus d’informations sur l’évaluation de l’intégrité du client, consultez Surveiller les clients.

CCMEVALHOUR

Heure de la journée à laquelle l’outil d’évaluation de l’intégrité du client (ccmeval.exe) s’exécute. Spécifiez une valeur entière comprise entre 0 (minuit) et 23 (23 :00). Par défaut, ccmeval s’exécute à minuit.

Pour plus d’informations sur l’évaluation de l’intégrité du client, consultez Surveiller les clients.

CCMFIRSTCERT

Si vous définissez cette propriété sur 1, le client sélectionne le certificat PKI avec la période de validité la plus longue.

Exemple : CCMSetup.exe /UsePKICert CCMFIRSTCERT=1

CCMHOSTNAME

Si le client est géré sur Internet, cette propriété spécifie le nom de domaine complet du point de gestion basé sur Internet.

Ne spécifiez pas cette option avec la propriété d’installation de SMSSITECODE=AUTO. Attribuez directement des clients basés sur Internet à un site Internet.

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

Cette propriété peut spécifier l’adresse d’une passerelle de gestion cloud (CMG). Pour obtenir la valeur de cette propriété, procédez comme suit :

• Créez une passerelle de gestion cloud. Pour plus d’informations, consultez Configurer une passerelle de gestion cloud.

• Sur un client actif, ouvrez une invite de commandes Windows PowerShell en tant qu’administrateur.

• Exécutez la commande suivante :

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

• Utilisez la valeur retournée telle qu’elle est avec la CCMHOSTNAME propriété .

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

CCMHTTPPORT

Spécifie le port que le client doit utiliser lorsqu’il communique via HTTP avec des serveurs de système de site. Par défaut, cette valeur est 80.

Exemple : CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORT

Spécifie le port que le client doit utiliser lorsqu’il communique via HTTPS aux serveurs de système de site. Par défaut, cette valeur est 443.

Exemple : CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

Utilisez cette propriété pour définir le dossier afin d’installer les fichiers client Configuration Manager. Par défaut, il utilise %WinDir%\CCM.

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

CCMLOGLEVEL

Utilisez cette propriété pour spécifier le niveau de détail à écrire dans Configuration Manager fichiers journaux.

Valeurs prises en charge :

• 0:Verbose
• 1:Par défaut
• 2: avertissements et erreurs
• 3: erreurs uniquement

Exemple : CCMSetup.exe CCMLOGLEVEL=0

Pour plus d’informations, consultez À propos des fichiers journaux.

CCMLOGMAXHISTORY

Lorsqu’un fichier journal Configuration Manager atteint la taille maximale, le client le renomme en tant que sauvegarde et crée un fichier journal. Cette propriété spécifie le nombre de versions précédentes du fichier journal à conserver. La valeur par défaut est 1. Si vous définissez la valeur 0sur , le client ne conserve aucun historique de fichier journal.

Exemple : CCMSetup.exe CCMLOGMAXHISTORY=5

Pour plus d’informations, consultez À propos des fichiers journaux.

CCMLOGMAXSIZE

Cette propriété spécifie la taille maximale du fichier journal en octets. Lorsqu’un journal atteint la taille spécifiée, le client le renomme en fichier d’historique et en crée un. La taille par défaut est de 250 000 octets et la taille minimale est de 10 000 octets.

Exemple : CCMSetup.exe CCMLOGMAXSIZE=300000 (300 000 octets)

DISABLESITEOPT

Définissez cette propriété sur TRUE pour empêcher les administrateurs de modifier le site affecté dans le panneau de configuration Configuration Manager.

Exemple : CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

Si elle est définie sur TRUE, cette propriété empêche les utilisateurs administratifs de modifier les paramètres du dossier du cache client dans le panneau de configuration Configuration Manager.

Exemple : CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIX

Spécifiez un domaine DNS pour les clients afin de localiser les points de gestion que vous publiez dans DNS. Lorsque le client localise un point de gestion, il indique au client d’autres points de gestion dans la hiérarchie. Ce comportement signifie que le point de gestion que le client trouve à partir de DNS peut être n’importe lequel dans la hiérarchie.

Pour plus d’informations sur la publication DNS en tant que méthode d’emplacement de service pour les clients Configuration Manager, consultez Emplacement du service et comment les clients déterminent leur point de gestion attribué.

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

FSP

Spécifiez le point de status de secours qui reçoit et traite les messages d’état envoyés par Configuration Manager clients.

Pour plus d’informations, consultez Déterminer si vous avez besoin d’un point de status de secours.

Exemple : CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

Si vous définissez cette propriété sur TRUE, le programme d’installation du client n’case activée pas la version minimale requise de Microsoft Application Virtualization (App-V).

Exemple : CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

MANAGEDINSTALLER

Si vous définissez cette propriété sur 1 , ccmsetup.exe et client.msi sont définis en tant que programmes d’installation gérés. Pour plus d’informations, consultez Autoriser automatiquement les applications déployées par un programme d’installation managé avec Windows Defender Contrôle d’application.

Exemple : CCMSetup.exe MANAGEDINSTALLER=1

NOTIFYONLY

Lorsque vous activez cette propriété, le client signale status, mais ne résout pas les problèmes qu’il détecte.

Exemple : CCMSetup.exe NOTIFYONLY=TRUE

Pour plus d’informations, consultez Guide pratique pour configurer les status client.

PROVISIONTS

Utilisez cette propriété pour démarrer une séquence de tâches sur un client après son inscription auprès du site.

Par exemple, vous approvisionnez un nouvel appareil Windows avec Windows Autopilot, vous l’inscrivez automatiquement pour Microsoft Intune, puis installez le client Configuration Manager pour la cogestion. Si vous spécifiez cette nouvelle option, le client nouvellement approvisionné exécute une séquence de tâches. Ce processus vous offre une flexibilité supplémentaire pour installer des applications et des mises à jour logicielles, ou configurer des paramètres.

Utilisez le processus suivant :

1. Créez une séquence de tâches de déploiement non-système d’exploitation pour installer des applications, installer des mises à jour logicielles et configurer les paramètres.

2. Déployez cette séquence de tâches dans le nouveau regroupement intégré, Tous les appareils de provisionnement. Notez l’ID de déploiement de la séquence de tâches, par exemple PRI20001.

   Conseil

   L’objectif du déploiement peut être disponible ou obligatoire. Étant donné que vous spécifiez l’ID de déploiement comme valeur de propriété, l’objectif n’a pas d’importance.

3. Installez le client Configuration Manager sur un appareil à l’aide deccmsetup.msiet incluez la propriété suivante : PROVISIONTS=PRI20001. Définissez la valeur de cette propriété comme ID de déploiement de la séquence de tâches.

   • Si vous installez le client à partir d’Intune pendant l’inscription à la cogestion, consultez Comment préparer des appareils Basés sur Internet pour la cogestion.

     Remarque

     Cette méthode peut avoir des prérequis supplémentaires. Par exemple, l’inscription du site à Microsoft Entra ID ou la création d’une passerelle de gestion cloud compatible avec le contenu.

     Quelle que soit la méthode , utilisez uniquement cette propriété avec ccmsetup.msi.

Une fois que le client est installé et inscrit correctement auprès du site, il démarre la séquence de tâches référencée. Si l’inscription du client échoue, la séquence de tâches ne démarre pas.

RESETKEYINFORMATION

Si un client n’a pas la bonne Configuration Manager clé racine approuvée, il ne peut pas contacter un point de gestion approuvé pour recevoir la nouvelle clé racine approuvée. Utilisez cette propriété pour supprimer l’ancienne clé racine approuvée. Cette situation peut se produire lorsque vous déplacez un client d’une hiérarchie de site à une autre. Cette propriété s’applique aux clients qui utilisent la communication client HTTP et HTTPS. Pour plus d’informations, consultez Planification de la clé racine approuvée.

Exemple : CCMSetup.exe RESETKEYINFORMATION=TRUE

SITEREASSIGN

Active la réaffectation automatique de site pour les mises à niveau du client lorsqu’elle est utilisée avec SMSSITECODE=AUTO.

Exemple : CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE

SMSCACHEDIR

Spécifie l’emplacement du dossier de cache du client sur l’ordinateur client. Par défaut, l’emplacement du cache est %WinDir%\ccmcache.

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

Utilisez cette propriété avec la SMSCACHEFLAGS propriété pour contrôler l’emplacement du dossier du cache client. Par exemple, pour installer le dossier de cache du client sur le plus grand lecteur de disque client disponible : CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE

SMSCACHEFLAGS

Utilisez cette propriété pour spécifier d’autres détails d’installation pour le dossier du cache client. Vous pouvez utiliser SMSCACHEFLAGS des propriétés individuellement ou en combinaison séparées par des points-virgules (;).

Si vous n’incluez pas cette propriété :

• Le client installe le dossier de cache en fonction de la SMSCACHEDIR propriété
• Le dossier n’est pas compressé
• Le client utilise la SMSCACHESIZE propriété comme limite de taille en Mo du cache

Lorsque vous mettez à niveau un client existant, le programme d’installation du client ignore cette propriété.

Valeurs de la SMSCACHEFLAGS propriété

• PERCENTDISKSPACE: définissez la taille du cache sous la forme d’un pourcentage de l’espace disque total . Si vous spécifiez cette propriété, définissez SMSCACHESIZE également sur une valeur de pourcentage.

• PERCENTFREEDISKSPACE: définissez la taille du cache sous la forme d’un pourcentage de l’espace disque libre . Si vous spécifiez cette propriété, définissez SMSCACHESIZE également en tant que valeur de pourcentage. Par exemple, le disque est libre de 10 Mo et vous spécifiez SMSCACHESIZE=50. Le programme d’installation du client définit la taille du cache sur 5 Mo. Vous ne pouvez pas utiliser cette propriété avec la PERCENTDISKSPACE propriété .

• MAXDRIVE: installez le cache sur le plus grand disque disponible. Si vous spécifiez un chemin d’accès avec la SMSCACHEDIR propriété , le programme d’installation du client ignore cette valeur.

• MAXDRIVESPACE: installez le cache sur le lecteur de disque avec le plus d’espace libre. Si vous spécifiez un chemin d’accès avec la SMSCACHEDIR propriété , le programme d’installation du client ignore cette valeur.

• NTFSONLY: installez uniquement le cache sur un lecteur de disque au format NTFS. Si vous spécifiez un chemin d’accès avec la SMSCACHEDIR propriété , le programme d’installation du client ignore cette valeur.

• COMPRESS: stockez le cache dans un formulaire compressé.

• FAILIFNOSPACE: s’il n’y a pas suffisamment d’espace pour installer le cache, supprimez le client Configuration Manager.

Exemple : CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

Lorsque vous mettez à niveau un client existant, le programme d’installation du client ignore ce paramètre. Le client ignore également la taille du cache lorsqu’il télécharge les mises à jour logicielles.

Exemple : CCMSetup.exe SMSCACHESIZE=100

SMSCONFIGSOURCE

Utilisez cette propriété pour spécifier l’emplacement et l’ordre que le programme d’installation du client vérifie les paramètres de configuration. Il s’agit d’une chaîne d’un ou plusieurs caractères, chacun définissant une source de configuration spécifique :

• R: recherchez les paramètres de configuration dans le Registre.

  Pour plus d’informations, consultez Provisionner les propriétés d’installation du client.

• P: recherchez les paramètres de configuration dans les propriétés d’installation à partir de la ligne de commande.

• M: vérifiez les paramètres existants lorsque vous mettez à niveau un client plus ancien.

• U: Mettez à niveau le client installé vers une version plus récente et utilisez le code de site attribué.

Par défaut, le programme d’installation du client utilise PU. Il vérifie d’abord les propriétés d’installation (P), puis les paramètres existants (U).

Exemple : CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMP

Spécifie un point de gestion initial que le client Configuration Manager doit utiliser.

Exemples :

• CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSMPLIST

Spécifie une liste de points de gestion que le client Configuration Manager doit utiliser. Utilisez un point-virgule (;) comme délimiteur lorsque vous spécifiez plusieurs points de gestion.

Exemples :

• 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

Si le client ne peut pas obtenir la clé racine Configuration Manager approuvée à partir de services de domaine Active Directory, utilisez cette propriété pour spécifier la clé. Cette propriété s’applique aux clients qui utilisent la communication HTTP et HTTPS. Pour plus d’informations, consultez Planification de la clé racine approuvée.

Exemple : CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

SMSROOTKEYPATH

Utilisez cette propriété pour réinstaller la Configuration Manager clé racine approuvée. Il spécifie le chemin d’accès complet et le nom d’un fichier qui contient la clé racine approuvée. Cette propriété s’applique aux clients qui utilisent la communication client HTTP et HTTPS. Pour plus d’informations, consultez Planification de la clé racine approuvée.

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

SMSSIGNCERT

Spécifie le chemin d’accès complet et le nom du certificat auto-signé exporté sur le serveur de site. Le serveur de site stocke ce certificat dans le magasin de certificats SMS . Il porte le nom de l’objet Serveur de site et le nom convivial Certificat de signature du serveur de site.

Exportez le certificat sans la clé privée, stockez le fichier en toute sécurité et accédez-y uniquement à partir d’un canal sécurisé.

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

SMSSITECODE

Cette propriété spécifie un site Configuration Manager auquel vous affectez le client. Cette valeur peut être un code de site à trois caractères ou le mot AUTO. Si vous spécifiez AUTOou si vous ne spécifiez pas cette propriété, le client tente de déterminer son affectation de site à partir de services de domaine Active Directory ou d’un point de gestion spécifié. Pour activer AUTO les mises à niveau du client, définissez également SITEREASSIGN=TRUE.

Exemple : CCMSetup.exe SMSSITECODE=XZY

UPGRADETOLATEST

Cette propriété force CCMSetup à envoyer une demande d’emplacement au point de gestion pour obtenir la dernière version de la source d’installation du client Configuration Manager. Il existe plusieurs scénarios où cette propriété est particulièrement utile :

• Clients de préproduction. Un client nouvellement installé utilise la base de référence de production, car il ne peut pas évaluer le regroupement de préproduction tant que le client n’est pas installé. Dans ce scénario, une fois que le client est installé et qu’il évalue la stratégie, il effectue une mise à niveau ultérieure vers la version du client de préproduction. Utilisez cette propriété pour que l’appareil installe immédiatement la dernière version du client.

  Ce scénario inclut également l’utilisation d’Autopilot dans la cogestion. Utilisez cette propriété pour vous assurer que l’appareil Autopilot nouvellement approvisionné utilise immédiatement la version du client de préproduction.

• Points de distribution d’extraction. Autorisez les points de distribution d’extraction à installer la dernière version du client, même si elle n’est pas dans la collection de préproduction. Cette action garantit que la version du client sur le point de distribution d’extraction est identique à celle des fichiers binaires du point de distribution. Si ces versions ne sont pas les mêmes, cela peut entraîner des problèmes.

Valeurs d’attribut pour les critères de sélection de certificat

Configuration Manager prend en charge les valeurs d’attribut suivantes pour les critères de sélection de certificat PKI :

Attribut OID	Attribut de nom unique	Définition d’attribut
0.9.2342.19200300.100.1.25	DC	Composant de domaine
1.2.840.113549.1.9.1	E-mail ou e-mail	Adresse électronique
2.5.4.3	CN	Nom commun
2.5.4.4	SN	Nom de sujet
2.5.4.5	SERIALNUMBER	Numéro de série
2.5.4.6	C	Code du pays
2.5.4.7	L	Localité
2.5.4.8	S ou ST	Nom de l’état ou de la province
2.5.4.9	RUE	Rue
2.5.4.10	O	Nom de l’organisation
2.5.4.11	Unité d’organisation	Unité d’organisation
2.5.4.12	T ou Titre	Titre
2.5.4.42	G ou GN ou GivenName	Nom donné
2.5.4.43	I ou Initiales	Initials
2.5.29.17	(aucune valeur)	Autre nom de l’objet

Installation poussée du client

Si vous utilisez la méthode d’installation push du client, utilisez les options suivantes sous l’onglet Client des propriétés d’installation push du client dans la console Configuration Manager :

• L’une des propriétésClient.msi

• Le sous-ensemble suivant de paramètres de ligne de commandeCCMSetup.exe est autorisé pour l’envoi (push) du client :

  • /AllowMetered (à partir de la version 2103)

  • /AlwaysExcludeUpgrade

  • /BITSPriority

  • /downloadtimeout

  • /ExcludeFeatures

  • /forcereboot

  • /logon

  • /skipprereq

  • /UsePKICert