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

Mises à jour vers Configuration Manager (Current Branch)

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

À propos CCMSetup.exe

La 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 les éléments suivants :

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

  • Conditions préalables client

  • Mises à jour et correctifs pour le client Configuration Manager

Notes

Vous ne pouvez pas installer directement client.msi.

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 plus faibles. Vous spécifiez la valeur d’un paramètre si nécessaire à l’aide d’un deux-points ( : ) immédiatement suivi de la valeur. Pour plus d’informations, CCMSetup.exe paramètres de ligne de commande.

Vous pouvez également fournir des propriétés sur CCMSetup.exe ligne de commande pour modifier le comportement des client.msi. Les propriétés par convention sont en haut de la case. 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, voirClient.msi propriétés.

Important

Spécifiez les paramètres CCMSetup avant de spécifier les propriétés des client.msi.

CCMSetup.exe et les fichiers de prise en charge se sont situés 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 sites. Par exemple, \\SiteServer\SMS_ABC\Client.

À l’invite de commandes, CCMSetup.exe commande 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 fait les choses suivantes :

  • Spécifie le point de gestion nommé SMSMP01 pour 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 utiliser le point d’état de retour nommé SMSFP01.

Conseil

Si une valeur de paramètre possède des espaces, entourez-la de guillemets.

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

CCMSetup.exe de ligne de commande

/?

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

Exemple : ccmsetup.exe /?

/AllowMetered

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

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

  1. Stratégie de client local existante
  2. Dernière ligne de commande stockée dans le Windows registre
  3. Paramètres de la ligne de commande ccmsetup

/AlwaysExcludeUpgrade

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

Valeurs pris en charge :

  • TRUE: le client ne sera pas mis à niveau automatiquement
  • FALSE: le client est automatiquement mis à niveau (par défaut)

Par exemple :

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

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

Notes

Lorsque vous utilisez le paramètre /AlwaysExcludeUpgrade, la mise à niveau automatique s’exécute toujours. Toutefois, lorsque CCMSetup s’exécute pour effectuer la mise à niveau, il note que le paramètre /AlwaysExcludeUpgrade a été définie et enregistre la ligne suivante dans le fichier ccmsetup.log:

Client is stamped with /alwaysexcludeupgrade. Stop proceeding.

CCMSetup se quittera immédiatement et n’effectuera pas la mise à niveau.

/BITSPriority

Lorsque l’appareil télécharge des fichiers d’installation client sur 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 (valeur 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 paramètre /noservice, 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 dossier du répertoire d’installation configuration Manager sur \bin\<platform> 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 [Client Install] d’entrée 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 maximal en minutes. Après ce délai, CCMSetup cesse de tenter de télécharger les fichiers d’installation. La valeur par défaut est 1 440 minutes (un jour).

Utilisez le paramètre /retry pour spécifier l’intervalle entre les 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.

Notes

ClientUI est la seule valeur que le paramètre /ExcludeFeatures prend en charge.

/forceinstall

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

/forcereboot

Utilisez ce paramètre pour forcer le redémarrage de l’ordinateur si nécessaire pour terminer l’installation. Si vous ne spécifiez pas ce paramètre, CCMSetup se quitte 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 source pour les ordinateurs à connecter. Les ordinateurs utilisent ce point de gestion pour rechercher le point de distribution le plus proche pour les fichiers d’installation. S’il n’existe aucun point de distribution ou si les ordinateurs ne peuvent pas télécharger les fichiers à partir des points de distribution après 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 du contenu, voir Groupes de limites - installation du client. Cet article inclut également des détails sur le comportement de ccmsetup si vous utilisez les paramètres /mp et /source.

Important

Ce paramètre spécifie un point de gestion initial pour que les ordinateurs trouvent une source de téléchargement et peut être n’importe quel point de gestion dans n’importe quel site. Il n’affecte pas le client au point de gestion spécifié.

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

Vous pouvez utiliser le paramètre de ligne de commande /mp pour spécifier plusieurs points de gestion. Si l’ordinateur ne parvient pas à se connecter au premier, il essaie 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 à l’objet ou à l’autre nom du sujet du certificat PKI du point de gestion. Bien que Configuration Manager prend 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 FQDN : 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, utilisez les étapes suivantes :

  • Créez un CMG. Pour plus d’informations, voir Configurer un CMG.

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

  • Exécutez la commande suivante :

    (Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MP
    
  • Append the https:// prefix to use with the /mp parameter.

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

Important

Lorsque vous spécifiez l’URL d’une passerelle de gestion cloud pour le paramètre /mp, elle doit commencer par https:// .

/NoCRLCheck

Spécifie qu’un client ne doit pas vérifier la liste de révocation de certificats (CRL) lorsqu’il communique sur HTTPS avec un certificat pKI. Lorsque vous ne spécifiez pas ce paramètre, le client vérifie la liste de contrôle d’adresses avant d’établir une connexion HTTPS. Pour plus d’informations sur la vérification de la liste de révocation de certificats client, voir Planning for PKI certificate revocation.

Exemple : CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

Ce paramètre empêche CCMSetup de s’exécute 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. Il se peut que ce compte ne dispose pas 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, voir l’authentification basée sur un jeton pour CMG.

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

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

Conseil

Si CCMSetup renvoie une erreur 0x87d0027e, essayez de supprimer le paramètre /mp de la ligne de commande.

/retry

Si CCMSetup.exe télécharger les fichiers d’installation, utilisez ce paramètre pour spécifier l’intervalle de nouvelle tentative en minutes. CCMSetup continue à réessayer jusqu’à atteindre la limite spécifiée dans le paramètre /downloadtimeout.

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.

Conseil

Si vous utilisez un script pour exécuter CCMSetup.exe avec le paramètre /service, CCMSetup.exe se quitte après le démarrage du service. Il se peut qu’il ne signale pas correctement les détails de l’installation au script.

Exemple : ccmsetup.exe /service

/skipprereq

Ce paramètre spécifie que CCMSetup.exe n’installe pas la condition préalable spécifiée. 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 conditions préalables client, voir Windows prérequis client.

/source

Spécifie l’emplacement de téléchargement du fichier. Utilisez un chemin d’accès LOCAL ou UNC. L’appareil télécharge les fichiers à l’aide du protocole SMB (Server Message Block). Pour utiliser /source, le compte d Windows d’utilisateur 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 du contenu, voir Groupes de limites - installation du client. Cet article inclut également des détails sur le comportement de ccmsetup si vous utilisez les paramètres /mp et /source.

Conseil

Vous pouvez utiliser le paramètre /source plusieurs fois dans une ligne de commande pour spécifier d’autres emplacements de téléchargement.

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

/uninstall

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

Exemple : ccmsetup.exe /uninstall

Notes

À partir de la version 2111, lorsque vous désinstallez le client, il supprime également le démarrage du client, ccmsetup.msi, s’il existe.

/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 Azure Active Directory (Azure AD) pour l’authentification client et possède également un certificat d’authentification client basé sur l’kir PKI, si vous utilisez ce paramètre, le client ne sera pas en mesure d’obtenir des informations d’intégration Azure AD à partir d’une passerelle de gestion cloud (CMG). Pour un client qui utilise l’authentification Azure AD, ne spécifiez pas ce paramètre, mais incluez les propriétés AADRESOURCEURI et AADCLIENTAPPID.

Notes

Dans certains scénarios, vous n’avez pas besoin de spécifier ce paramètre, mais utilisez toujours un certificat client. Par exemple, l’installation de client push client et basée sur la mise à jour logicielle. Utilisez ce paramètre lorsque vous installez manuellement un client et utilisez le paramètre /mp avec un point de gestion httpS.

Spécifiez également ce paramètre lorsque vous installez un client pour les communications internet uniquement. Utiliser avec les propriétés pour le point de gestion basé sur CCMALWAYSINF=1 Internet (CCMHOSTNAME) et le code de site (SMSSITECODE). Pour plus d’informations sur la gestion des clients basés sur Internet, voir Considérations pour les communications client à partir d’Internet ou d’une forêt nontrue.

/IgnoreSkipUpgrade

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

CCMSetup.exe codes de retour

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

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

Ccmsetup.msi propriétés

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

CCMSETUPCMD

Utilisez cette ccmsetup. propriété msi pour transmettre des propriétés et paramètres de ligne de commande supplémentaires à ccmsetup. exe. Inclure 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"

Conseil

Microsoft Intune limite la ligne de commande à 1 024 caractères.

Client.msi propriétés

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

AADCLIENTAPPID

Spécifie l’identificateur Azure Active Directory (Azure AD) d’application cliente. 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, voir obtenir l’ID de l’application. Pour la propriété AADCLIENTAPPID, 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 Azure AD’application serveur. 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 de l’ID d’application.

Un administrateur Azure peut obtenir la valeur de cette propriété à partir du portail Azure. Dans Azure Active Directory, recherchez l’application serveur sous Inscriptions d’application. Recherchez le type d’application Web app/API. Ouvrez l’application, sélectionnez Paramètres, puis sélectionnez Propriétés. Utilisez la valeur d’URI ID d’application pour cette propriété d’installation du client AADRESOURCEURI.

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

AADTENANTID

Spécifie l’identificateur Azure AD client. Configuration Manager est lié à ce client lorsque vous configurez les services Azure pour la gestion cloud. Pour obtenir la valeur de cette propriété, utilisez les étapes suivantes :

  • Sur un appareil qui s’Windows 10 ou une Azure AD, 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

    Notes

    Un administrateur Azure peut également obtenir cette valeur dans le portail Azure. Pour plus d’informations, voir obtenir l’ID de client.

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

CCMADMINS

Spécifie un ou plusieurs Windows ou groupes d’utilisateurs à donner accès aux stratégies et paramètres clients. Cette propriété est utile lorsque vous n’avez pas d’informations d’identification administratives 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 silencieusement après l’installation du client.

Important

Lorsque vous utilisez cette propriété, l’ordinateur redémarre sans avertissement. Ce comportement se produit même si un utilisateur est Windows.

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 Toujours Internet.

Utilisez cette propriété avec CCMHOSTNAME pour spécifier le nom de domaine général (FQDN) du point de gestion basé sur Internet. Utilisez-le également avec le paramètre CCMSetup UsePKICert et la propriété SMSSITECODE.

Pour plus d’informations sur la gestion des clients basés sur Internet, voir Considérations pour les communications client à partir d’Internet ou d’une forêt nontrue.

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 inclut des informations de certificat pour les autorités de certification racines de confiance (CA) qui sont fiables par le site Configuration Manager.

Cette valeur est une correspondance sensible à la cas pour les attributs du sujet qui se trouve dans le certificat d’ac racine. Séparez les attributs par une virgule ( , ) ou un point-virgule ( ; ). Spécifiez plusieurs certificats d’ac 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."

Conseil

Utilisez la valeur de l’attribut CertificateIssuers dans le fichier mobileclient.tcf pour le site. Ce fichier se trouve dans le \bin\<platform> sous-dossier du répertoire d’installation de Configuration Manager sur le serveur de site.

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 du certificat, voir Planification de la sélection de certificat client pKI.

CCMCERTSEL

Si le client possè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 du sujet ou l’autre nom du sujet du certificat :

  • Objet: Rechercher une correspondance exacte
  • SubjectStr: rechercher une correspondance partielle

Exemples :

  • CCMCERTSEL="Subject:computer1.contoso.com": recherchez un certificat qui correspond exactement au nom de l’ordinateur dans le nom du sujet ou computer1.contoso.com l’autre nom du sujet.

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

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

Exemples :

  • CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": recherchez l’attribut d’unité d’organisation exprimé sous la mesure d’un identificateur d’objet et nommé Computers .

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

Important

Si vous utilisez le nom de l’objet, le mot clé Subject est sensible à la cas et le mot clé SubjectStr ne le fait pas.

Si vous utilisez l’autre nom du sujet, les mots clés Subject et SubjectStr ne sont pas sensibles à la cas.

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

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

CCMCERTSTORE

Si le programme d’installation du client ne peut pas localiser un certificat valide dans le magasin de certificats personnels par défaut de 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 lorsque le client s’installe. Cette propriété entraîne le client à enregistrer des informations de bas niveau pour la 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. Activez également CCMENABLELOGGING.

Valeurs pris 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, voir à propos des fichiers journaux.

CCMENABLELOGGING

Configuration Manager active la journalisation par défaut.

Valeurs pris en charge :

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

Exemple : CCMSetup.exe CCMENABLELOGGING=TRUE

Pour plus d’informations, voir à propos des fichiers journaux.

CCMEVALINTERVAL

Fréquence en minutes à laquelle l’outil d’évaluation de l’état d'ccmeval.exe client s’exécute. Spécifiez une valeur d’un nombre nombre integer 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’état du client, voir Surveiller les clients.

CCMEVALHOUR

Heure de la journée à l’aide de l’outil d’évaluation de l’état d'ccmeval.exe client. Spécifiez une valeur d’un nombre nombre integer entre 0 (minuit) et 23 (23:00 PM). Par défaut, ccmeval s’exécute à minuit.

Pour plus d’informations sur l’évaluation de l’état du client, voir Surveiller les clients.

CCMFIRSTCERT

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

Exemple : CCMSetup.exe /UsePKICert CCMFIRSTCERT=1

CCMHOSTNAME

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

Ne spécifiez pas cette option avec la propriété d’installation de SMSSITECODE=AUTO. Affectez directement des clients 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é, utilisez les étapes suivantes :

  • Créez un CMG. Pour plus d’informations, voir Configurer un CMG.

  • Sur un client actif, ouvrez une invite Windows PowerShell commande 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 renvoyée telle quelle avec la propriété CCMHOSTNAME.

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

Important

Lorsque vous spécifiez l’adresse d’un CMG pour la propriété CCMHOSTNAME, n’indiquez pas de préfixe tel que https:// . Utilisez uniquement ce préfixe avec l’URL /mp d’un CMG.

CCMHTTPPORT

Spécifie le port que le client doit utiliser lorsqu’il communique sur HTTP avec les serveurs système du 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 par le protocole HTTPS avec les serveurs système du 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 clients Configuration Manager. Par défaut, il utilise %WinDir%\CCM .

Conseil

Quel que soit l’endroit où vous installez les fichiers clients, il installe toujours leccmcore.dll dans le %WinDir%\System32 dossier. Sur un système d’exploitation 64 bits, il installe une copie des ccmcore.dll dans le %WinDir%\SysWOW64 dossier. Ce fichier prend en charge les applications 32 bits qui utilisent la version 32 bits des API clientes du SDK Configuration Manager.

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

CCMLOGLEVEL

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

Valeurs pris en charge :

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

Exemple : CCMSetup.exe CCMLOGLEVEL=0

Pour plus d’informations, voir à 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 nouveau 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 sur , le client ne conserve aucun historique 0 des fichiers journaux.

Exemple : CCMSetup.exe CCMLOGMAXHISTORY=5

Pour plus d’informations, voir à 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 tant que fichier d’historique et en crée un nouveau. 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é pour empêcher les administrateurs de modifier le site affecté dans TRUE le panneau de configuration Configuration Manager.

Exemple : CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

Si elle est définie sur TRUE, cette propriété désactive la possibilité pour les utilisateurs d’administration de modifier les paramètres du dossier de cache client dans le panneau de configuration Configuration Manager.

Exemple : CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIX

Spécifiez un domaine DNS pour que les clients recherchent les points de gestion que vous publiez dans DNS. Lorsque le client localise un point de gestion, il lui indique les autres points de gestion dans la hiérarchie. Ce comportement signifie que le point de gestion que le client trouve dans DNS peut être n’importe quel point de la hiérarchie.

Notes

Vous n’avez pas besoin de spécifier cette propriété si le client se trouve dans le même domaine qu’un point de gestion publié. Dans ce cas, le domaine du client est automatiquement utilisé pour rechercher des points de gestion dans DNS.

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

Notes

Par défaut, Configuration Manager n’active pas la publication DNS.

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

FSP

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

Pour plus d’informations, voir Déterminer si vous avez besoin d’un point d’état de retour.

Exemple : CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

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

Important

Si vous installez le client Configuration Manager sans installer App-V, vous ne pouvez pas déployer d’applications virtuelles.

Exemple : CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

NOTIFYONLY

Lorsque vous activez cette propriété, le client signale l’état, mais ne remédie pas aux problèmes qu’il trouve.

Exemple : CCMSetup.exe NOTIFYONLY=TRUE

Pour plus d’informations, voir Comment configurer l’état du 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.

Notes

Si la séquence de tâches installe des mises à jour logicielles ou des applications, les clients ont besoin d’un certificat d’authentification client valide. L’authentification par jeton à elle seule ne fonctionne pas. Pour plus d’informations, voir Notes de publication - Déploiement du système d’exploitation.

Par exemple, vous devez mettre en service un nouvel appareil Windows avec Windows Autopilot, l’inscrire automatiquement à Microsoft Intune, puis installer le client Configuration Manager pour la cogestion. Si vous spécifiez cette nouvelle option, le client nouvellement provisioné exécute ensuite une séquence de tâches. Ce processus vous offre davantage de flexibilité 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 hors 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 sur la nouvelle collection intégrée, Tous les périphériques d’approvisionnement. Notez l’ID de déploiement de la séquence de tâches, par PRI20001 exemple.

    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'ccmsetup.msiet incluez la propriété suivante : **** PROVISIONTS=PRI20001 Définissez la valeur de cette propriété en tant qu’ID de déploiement de séquence de tâches.

    • Si vous installez le client à partir d’Intune lors de l’inscription à la cogestion, voir Comment préparer les appareils internet pour la cogestion.

      Notes

      Cette méthode peut avoir des conditions préalables supplémentaires. Par exemple, l’inscription du site à Azure Active Directory ou la création d’une passerelle de gestion cloud activée pour le contenu.

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

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

Notes

La séquence de tâches lancée par PROVISIONTS utilise le client par défaut Paramètres. Cette séquence de tâches démarre immédiatement après l’inscription du client, de sorte qu’elle ne fait pas partie d’une collection dans laquelle vous avez déployé des paramètres clients personnalisés. Le client ne traitera pas ou n’appliquera pas de paramètres clients personnalisés avant l’application de cette séquence de tâches.

Pour que la séquence de tâches fonctionne correctement, vous devrez peut-être modifier certains paramètres dans le client par défaut Paramètres. Par exemple :

  • Groupe Services cloud : autoriser les clients à utiliser une passerelle de gestion cloud et autoriser l’accès au point de distribution cloud
  • Groupe d’agents informatiques : stratégie d’exécution PowerShell

Si les appareils n’ont pas besoin de ces paramètres clients une fois la séquence de tâches terminée, déployez de nouveaux paramètres clients personnalisés pour inverser les paramètres par défaut.

Pour plus d’informations, voir à propos des paramètres du client.

RESETKEYINFORMATION

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

Exemple : CCMSetup.exe RESETKEYINFORMATION=TRUE

SITEREASSIGN

Active la réaffectation automatique des sites pour les mises à niveau client lorsqu’elles sont utilisées avec SMSSITECODE=AUTO.

Exemple : CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE

SMSCACHEDIR

Spécifie l’emplacement du dossier de cache 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 propriété SMSCACHEFLAGS pour contrôler l’emplacement du dossier de cache client. Par exemple, pour installer le dossier de cache 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 de cache client. Vous pouvez utiliser les propriétés SMSCACHEFLAGS individuellement ou en combinaison séparées par des points-virgules ( ; ).

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

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

Valeurs de la propriété SMSCACHEFLAGS

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

  • PERCENTFREEDISKSPACE: définir la taille du cache sous forme de pourcentage de l’espace disque disponible. Si vous spécifiez cette propriété, définissez également SMSCACHESIZE en tant que valeur de pourcentage. Par exemple, le disque dispose de 10 Mo gratuits, 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 propriété PERCENTDISKSPACE.

  • MAXDRIVE : installer le cache sur le plus grand disque disponible. Si vous spécifiez un chemin d’accès avec la propriété SMSCACHEDIR, 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 propriété SMSCACHEDIR, 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 propriété SMSCACHEDIR, le programme d’installation du client ignore cette valeur.

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

  • FAILIFNOSPACE : si l’espace est insuffisant pour installer le cache, supprimez le client Configuration Manager.

Exemple : CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

Important

Les paramètres clients sont disponibles pour spécifier la taille du dossier de cache client. L’ajout de ces paramètres clients remplace effectivement l’utilisation de SMSCACHESIZE en tant que propriété client.msi pour spécifier la taille du cache client. Pour plus d’informations, voir les paramètres du client pour la taille du cache.

Lorsque vous mettre à niveau un client existant, le programme d’installation du client ignore ce paramètre. Le client ignore également la taille du cache lors du téléchargement des mises à jour logicielles.

Exemple : CCMSetup.exe SMSCACHESIZE=100

Notes

Si vous réinstallez un client, vous ne pouvez pas utiliser SMSCACHESIZE ou SMSCACHEFLAGS pour définir une taille de cache plus petite qu’auparavant. La taille précédente est la valeur minimale.

SMSCONFIGSOURCE

Utilisez cette propriété pour spécifier l’emplacement et l’ordre dans le programme d’installation du client pour vérifier 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, voir Provision client installation properties.

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

  • M: Recherchez les paramètres existants lorsque vous mettrez à niveau un client plus ancien.

  • U: mettre à niveau le client installé vers une version plus récente et utiliser le code de site affecté.

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

Exemple : CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMP

Spécifie un point de gestion initial pour le client Configuration Manager à utiliser.

Important

Si le point de gestion accepte uniquement les connexions client sur HTTPS, préfixez le nom du point de gestion par https:// .

Exemples :

  • CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSPUBLICROOTKEY

Si le client ne peut pas obtenir la clé racine de confiance Configuration Manager à partir des 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, voir Planification de la clé racine de confiance.

Exemple : CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

Conseil

Obtenez la valeur de la clé racine de confiance du site à partir du fichier mobileclient.tcf sur le serveur de site. Pour plus d’informations, voir Pré-provisioner un client avec la clé racine de confiance à l’aide d’un fichier.

SMSROOTKEYPATH

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

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 a le nom d’objet Site Server et le nom convivial Site Server Signing Certificate.

Exportez le certificat sans 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 ou ne spécifiez pas cette propriété, le client tente de déterminer son affectation de site à partir des services de domaine Active Directory ou à partir AUTO d’un point de gestion spécifié. Pour activer AUTO les mises à niveau des clients, définissez également SITEREASSIGN=TRUE.

Notes

Si vous spécifiez également un point de gestion basé sur Internet avec la propriété CCMHOSTNAME, ne l’utilisez pas AUTO avec SMSSITECODE. Affectez directement le client à son site en spécifiant le code du site.

Exemple : CCMSetup.exe SMSSITECODE=XZY

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 Distinguished Name Définition d’attribut
0.9.2342.19200300.100.1.25 DC Composant de domaine
1.2.840.113549.1.9.1 E ou e-mail Adresse e-mail
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 pays
2.5.4.7 L Locality
2.5.4.8 S ou ST Nom de l’État ou de la province
2.5.4.9 STREET Rue
2.5.4.10 O Nom de l’organisation
2.5.4.11 OU 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 Initials Initials
2.5.29.17 (aucune valeur) Autre nom de l’objet

Installation push du client

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

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

  • Le sous-ensemble suivant de CCMSetup.exe de ligne de commande sont autorisés pour la commande push du client :

    • /AllowMetered (à partir de la version 2103)

    • /AlwaysExcludeUpgrade

    • /BITSPriority

    • /downloadtimeout

    • /ExcludeFeatures

    • /forcereboot

    • /logon

    • /skipprereq

    • /UsePKICert