Clés de fichier de script d’installation sans assistance

  • Article

S’applique à : Gestionnaire de Configuration (branche actuelle)

Cet article définit toutes les clés et valeurs à spécifier dans le fichier de .ini script d’installation. Utilisez ce fichier avec l’option /SCRIPT de ligne de commande pour effectuer une installation ou une récupération sans assistance d’un site Configuration Manager. Les tableaux de cet article montrent :

  • Clés de script d’installation disponibles et leurs valeurs correspondantes
  • Si elles sont requises
  • Quel type d’installation ils sont utilisés
  • Brève description de la clé

Si vous souhaitez en savoir plus, consultez les articles suivants :

Spécifiez les noms de section entre crochets ([]) : [<Section name>]. Par exemple : [Identification].

Lorsque vous fournissez des valeurs pour les clés, le nom de la clé doit être suivi d’un signe égal (=) et de la valeur de la clé : <Key name>=<Value>. Par exemple : CDLatest=1. Vérifiez que les clés se trouvent sous la section appropriée.

Chaque section et chaque valeur doivent être uniques dans un seul script. Par exemple, il ne peut y avoir qu’une [Identification] seule section et une Action seule clé.

Actions prises en charge

Un script est principalement défini par la Action clé de la Identification section . La liste suivante inclut toutes les actions actuellement prises en charge pour l’exécution du programme d’installation sans assistance :

  • InstallCAS: Installer un site d’administration centrale (CAS)
  • InstallPrimarySite: Installer un site principal
  • ManageLanguages: ajouter ou supprimer des langues clientes et serveurs
  • RecoverPrimarySite: Récupération d’un site principal
  • RecoverCCAR: Récupérer un site d’administration centrale

Installer un site

Identification section pour l’installation du site

Selon le type de site que vous installez, incluez les clés suivantes avec les valeurs appropriées dans la Identification section :

Nom de la clé Requis Valeurs Détails
Action Oui - InstallPrimarySite
- InstallCAS		 - Installer un site principal.
- Installer un site d’administration centrale (CAS)
CDLatest Oui 2 1: le programme d’installation s’exécute à partir de CD.Latest Lorsque vous exécutez le programme d’installation à partir du CD.Latest dossier , incluez cette clé et cette valeur. Cette valeur indique au programme d’installation que vous utilisez un média à partir de CD.Latest.

Remarque 2 : CDLatest obligatoire

La CDLatest clé n’est requise que lorsque vous exécutez le programme d’installation à partir du CD.Latest dossier pour installer un site principal ou un site d’administration centrale. Pour plus d’informations, consultez À propos du fichier de script de ligne de commande.

Options section pour l’installation du site

Incluez les clés suivantes dans la section Options pour installer un site :

Nom de la clé Requis Valeurs Détails
ProductID Oui -  xxxxx-xxxxx-xxxxx-xxxxx-xxxxx: clé de produit valide avec tirets
-  Eval: Installer la version d’évaluation		 Type de licence à installer.
SiteCode Oui Code à trois caractères, par exemple XYZ Code de site à trois caractères qui identifie de façon unique le site dans la hiérarchie.
SiteName Oui Un nom de site Nom convivial de ce site pour vous aider à l’identifier.
SMSInstallDir Oui Chemin d’accès au répertoire local Dossier d’installation pour les fichiers programme Configuration Manager.
SDKServer Oui Nom de domaine complet du fournisseur SMS Nom de domaine complet du premier serveur à héberger le fournisseur SMS.
PrerequisiteComp Oui - 0:Télécharger
- 1: déjà téléchargé		 Spécifiez si les fichiers prérequis ont déjà été téléchargés. Si vous utilisez la valeur , le programme d’installation 0télécharge les fichiers.
PrerequisitePath Oui Chemin d’accès au répertoire local Chemin d’accès aux fichiers prérequis. En fonction de la valeur, le PrerequisiteComp programme d’installation utilise ce chemin d’accès pour stocker les fichiers téléchargés ou pour localiser les fichiers précédemment téléchargés.
AdminConsole Oui - 0: Ne pas installer
- 1:Installer		 Spécifiez s’il faut installer la console Configuration Manager sur le serveur de site.
JoinCEIP Oui 0 Bien que la prise en charge du programme d’amélioration de l’expérience client (CEIP) ait été supprimée du produit, cette clé est toujours nécessaire.
MobileDeviceLanguage Oui - 0: Ne pas installer
- 1:Installer		 Spécifiez si les langues du client d’appareil mobile sont installées.

Lorsque vous installez un site, vous pouvez également spécifier les clés pour gérer les langues, telles que AddServerLanguages ou AddClientLanguages. Pour plus d’informations, consultez Options la section relative aux langues.

Les clés suivantes dans la Options section sont spécifiques à un site principal :

Nom de la clé Requis Valeurs Détails
ManagementPoint Non Nom de domaine complet MP Nom de domaine complet du serveur qui hébergera le premier rôle de système de site de point de gestion( MP).
ManagementPointProtocol Non HTTPS ou HTTP Protocole à utiliser pour le mp mp.
DistributionPoint Non Nom de domaine complet dp Nom de domaine complet du serveur qui hébergera le premier rôle de système de site de point de distribution (DP).
DistributionPointProtocol Non HTTPS ou HTTP Protocole à utiliser pour le dp.
DistributionPointInstallIIS Non - 0: Ne pas installer
- 1:Installer		 Spécifiez s’il faut installer IIS sur le dp.
RoleCommunicationProtocol Oui EnforceHTTPS ou HTTPorHTTPS Spécifiez s’il faut configurer tous les systèmes de site pour accepter uniquement les communications HTTPS des clients ou configurer la méthode de communication pour chaque rôle de système de site. Lorsque vous sélectionnez EnforceHTTPS, les clients ont besoin d’un certificat d’infrastructure à clé publique (PKI) valide pour l’authentification du client.
ClientsUsePKICertificate Oui - 0: Ne pas utiliser
- 1:Utiliser		 Spécifiez si les clients utiliseront un certificat PKI client pour communiquer avec les rôles de système de site.
UseFQDN Non - 0: Ne pas utiliser
- 1:Utiliser		 Spécifiez si le nom de domaine complet des systèmes de site doit être utilisé sur Internet.
ParentSiteCode Non Code de site Lorsque vous ajoutez un site principal enfant à une hiérarchie existante, spécifiez le code de site du site d’administration centrale.
ParentSiteServer Non FQDN Lorsque vous ajoutez un site principal enfant à une hiérarchie existante, spécifiez le nom de domaine complet du serveur d’administration centrale.

SQLConfigOptions section pour l’installation du site

Incluez les clés suivantes dans la SQLConfigOptions section pour installer un site :

Nom de la clé Requis Valeurs Détails
SQLServerName Oui Nom de domaine complet de SQL Server Nom du serveur ou de l’instance en cluster qui exécute SQL Server héberger la base de données du site.
DatabaseName Oui Nom ou
Instance\Nom		 Nom de la base de données SQL Server à créer ou à utiliser. S’il se trouve sur l’instance par défaut, spécifiez simplement le nom de la base de données. Sinon, spécifiez l’instance et le nom.
SQLServerPort Non Numéro de port Port utilisé par SQL Server. Par défaut, il utilise 1433.
SQLSSBPort Non Numéro de port Port SQL Server Service Broker (SSB). Par défaut, SSB utilise le port TCP 4022.
SQLDataFilePath Non Chemin d’accès au répertoire local Autre emplacement pour créer le fichier .mdb de base de données.
SQLLogFilePath Non Chemin d’accès au répertoire local Autre emplacement pour créer le fichier journal .ldf de base de données.
AGBackupShare Non Chemin d’accès du partage réseau Emplacement réseau pour le partage des sauvegardes de base de données lors de la création de la base de données de site dans un groupe de disponibilité. Le partage de sauvegarde n’est nécessaire que si l’amorçage automatique n’est pas défini.

CloudConnectorOptions section pour l’installation du site

Incluez les clés suivantes dans la CloudConnectorOptions section pour installer un site :

Nom de la clé Requis Valeurs Détails
CloudConnector Oui - 0: Ne pas installer
- 1:Installer		 Spécifiez s’il faut installer un point de connexion de service (SCP) sur ce site. Étant donné que vous ne pouvez installer le scp que sur le site de niveau supérieur d’une hiérarchie, définissez cette valeur 0 sur pour un site principal enfant.
CloudConnectorServer Oui* Nom de domaine complet scp Nom de domaine complet du serveur qui hébergera le rôle SCP. * Obligatoire uniquement quand CloudConnector est égal à 1.
UseProxy Oui* - 0: Aucun proxy
- 1: utiliser le proxy		 Spécifiez si le scp utilise un serveur proxy. * Obligatoire uniquement quand CloudConnector est égal à 1.
ProxyName Oui* Nom de domaine complet du proxy Nom de domaine complet du serveur proxy utilisé par le scp. * Obligatoire uniquement quand UseProxy est égal à 1.
ProxyPort Oui* Numéro de port Numéro de port du serveur proxy utilisé par le scp. * Obligatoire uniquement quand UseProxy est égal à 1.

SABranchOptions section pour l’installation du site

Incluez les clés suivantes dans la SABranchOptions section pour installer un site :

Nom de la clé Requis Valeurs Détails
SAActive Oui - 0: Vous n’avez pas de SA
- 1: SA est actif		 Spécifiez si vous disposez d’une Software Assurance (SA) active. Pour plus d’informations, consultez FAQ sur les produits et les licences.
CurrentBranch Oui - 0: Installer le LTSB
- 1: Installer Current Branch		 Spécifiez s’il faut utiliser Configuration Manager branche actuelle ou la branche de maintenance à long terme (LTSB). Pour plus d’informations, consultez Quelle branche de Configuration Manager dois-je utiliser ?
SAExpiration Non Date Date d’expiration de la sa, utilisée comme rappel pratique de cette date. Pour plus d’informations, consultez Licences et branches.

HierarchyExpansionOption section pour l’expansion du site

Lorsque vous installez un site d’administration centrale pour développer un site principal autonome dans une hiérarchie, utilisez les clés suivantes dans la HierarchyExpansionOption section :

Nom de la clé Requis Valeurs Détails
CCARSiteServer Non Nom de domaine complet cas Nom de domaine complet du site d’administration centrale auquel un site principal est attaché lorsqu’il rejoint la hiérarchie Configuration Manager. Spécifiez le site d’administration centrale pendant l’installation.
CASRetryInterval Non Minutes Si la connexion au site d’administration centrale échoue, le site principal attend ce nombre de minutes, puis retente la connexion.
WaitForCASTimeout Non 0 devient 100 Valeur de délai d’expiration maximale en minutes pour qu’un site principal se connecte au site d’administration centrale.
UseDistributionView Non - 0: Ne pas activer
- 1:Activer		 Spécifiez s’il faut utiliser des vues distribuées pour optimiser la réplication de base de données.
JoinPrimarySiteName Non Nom de domaine complet du serveur de site Nom de domaine complet du serveur de site principal à développer.

Gérer les langues

Identification section pour les langues

Incluez la clé suivante dans la Identification section pour gérer les langues :

Nom de la clé Requis Valeurs Détails
Action Oui ManageLanguages Gère la prise en charge linguistique du serveur, du client et du client mobile sur un site.

Options section pour les langues

Incluez les clés suivantes dans la Options section pour gérer les langues :

Nom de la clé Requis Valeurs Détails
AddServerLanguages Non Voir la note 1 Langues du serveur qui seront disponibles pour la console Configuration Manager, les rapports et d’autres objets.
AddClientLanguages Non Voir la note 1 Langues qui seront disponibles pour les ordinateurs clients.
DeleteServerLanguages Non Voir la note 1 Langues à supprimer. Ils ne seront plus disponibles pour la console Configuration Manager, les rapports et d’autres objets.
DeleteClientLanguages Non Voir la note 1 Langues à supprimer et qui ne seront plus disponibles pour les ordinateurs clients. L’anglais est disponible par défaut, vous ne pouvez pas le supprimer.
MobileDeviceLanguage Oui - 0: Ne pas installer
- 1:Installer		 Spécifiez si les langues du client d’appareil mobile sont installées.
PrerequisiteComp Oui - 0:Télécharger
- 1: déjà téléchargé		 Spécifiez si les fichiers prérequis ont déjà été téléchargés. Par exemple, si vous utilisez la valeur , le programme d’installation 0télécharge les fichiers.
PrerequisitePath Oui Chemin d’accès au répertoire local Chemin d’accès aux fichiers prérequis. En fonction de la valeur, le PrerequisiteComp programme d’installation utilise ce chemin d’accès pour stocker les fichiers téléchargés ou pour localiser les fichiers précédemment téléchargés.
ResetSecSiteLangs Non - 0: Ne pas réinitialiser
- 1:Réinitialiser		 Réinitialisez les modules linguistiques installés sur un site secondaire.

Remarque 1 : Valeurs de langue prises en charge

Utilisez le code à trois lettres pour les langues serveur ou les langues clientes prises en charge par Configuration Manager. Par exemple, pour ajouter la prise en charge de l’allemand sur le client, spécifiez la paire clé-valeur suivante : AddClientLanguages=DEU

L’anglais (ENG) est disponible par défaut. Vous n’avez pas besoin de l’ajouter et vous ne pouvez pas le supprimer.

Récupérer un site

Identification section pour la récupération de site

Selon le type de site que vous récupérez, incluez les clés suivantes avec les valeurs appropriées dans la Identification section :

Nom de la clé Requis Valeurs Détails
Action Oui - RecoverPrimarySite
- RecoverCCAR		 - Récupérer un site principal
- Récupérer un site d’administration centrale
CDLatest Oui 3 1: le programme d’installation s’exécute à partir de CD.Latest Lorsque vous exécutez le programme d’installation à partir du dossier CD.Latest, incluez cette clé et cette valeur. Cette valeur indique au programme d’installation que vous utilisez un média à partir de CD.Latest.

Remarque 3 : CDLatest obligatoire

La CDLatest clé n’est requise que lorsque vous exécutez le programme d’installation à partir du CD.Latest dossier pour récupérer un site. Pour plus d’informations, consultez À propos du fichier de script de ligne de commande.

RecoveryOptions section pour la récupération de site

Incluez les clés suivantes dans la RecoveryOptions section pour récupérer un site :

Nom de la clé Requis Valeurs Détails
ServerRecoveryOptions Oui - 1: Serveur de site et SQL Server
- 2: Serveur de site uniquement
- 4: SQL Server uniquement		 Composants à récupérer. Voir la note 4
DatabaseRecoveryOptions Oui* - 10: Restauration à partir d’une sauvegarde
- 20: récupéré manuellement
- 40: Créer une base de données
- 80: Ignorer		 Spécifiez comment le programme d’installation récupère la base de données de site dans SQL Server. * Obligatoire uniquement lorsque ServerRecoveryOptions est 1 ou 4.
ReferenceSite Oui* FQDN Site principal de référence utilisé par le site d’administration centrale pour récupérer des données globales. * Obligatoire uniquement lorsque DatabaseRecoveryOptions a la valeur 40. Voir la note 5
SiteServerBackupLocation Non Chemin d’accès au répertoire Chemin d’accès au jeu de sauvegarde du serveur de site. Si vous ne spécifiez pas de valeur, le programme d’installation réinstalle le site sans le restaurer à partir d’un jeu de sauvegarde.
BackupLocation Oui* Chemin d’accès au répertoire Chemin d’accès au jeu de sauvegarde de la base de données du site. * Obligatoire quand ServerRecoveryOptions a la valeur 1 ou 4, et DatabaseRecoveryOptions a la valeur 10.

Remarque 4 : ServerRecoveryOptions notes de valeur

  • 1 ou 2: pour récupérer le site à l’aide d’une sauvegarde de site, spécifiez une valeur pour SiteServerBackupLocation. Si vous ne spécifiez pas de valeur, le programme d’installation réinstalle le site sans le restaurer à partir d’un jeu de sauvegarde.

  • 4: la BackupLocation clé est requise lorsque vous configurez une valeur de 10 pour la DatabaseRecoveryOptions clé, qui consiste à restaurer la base de données du site à partir d’une sauvegarde.

Remarque 5 : ReferenceSite notes de valeur

  • Si la sauvegarde de base de données est antérieure à la période de rétention de suivi des modifications, ou lorsque vous récupérez le site sans sauvegarde, spécifiez le site principal de référence que le site d’administration centrale utilise pour récupérer les données globales.

  • Lorsque vous ne spécifiez pas de site de référence et que la sauvegarde est antérieure à la période de rétention de suivi des modifications, tous les sites principaux sont réinitialisés avec les données restaurées à partir du site d’administration centrale.

  • Lorsque vous ne spécifiez pas de site de référence et que la sauvegarde se trouve dans la période de rétention de suivi des modifications, seules les modifications effectuées après la sauvegarde sont répliquées à partir des sites principaux. Lorsqu’il y a des modifications en conflit à partir de différents sites principaux, le site d’administration centrale utilise le premier qu’il reçoit.

Options section pour la récupération de site

La plupart des clés de la Options section sont également requises pour la récupération de site. Pour plus d’informations, consultez Options la section relative à l’installation de site. Le tableau suivant récapitule les clés de la section pour la Options récupération de site :

Nom de la clé Requis Commentaire
ProductID Oui
SiteCode Oui Utilisez le même code de site que celui utilisé avant l’échec.
SiteName Non
SMSInstallDir Oui
SDKServer Oui Utilisez le même serveur que celui qui hébergeait ce rôle avant l’échec.
PrerequisiteComp Oui
PrerequisitePath Oui
AdminConsole Oui* * Obligatoire uniquement lorsque ServerRecoveryOptions est 1 ou 2.
JoinCEIP Oui

SQLConfigOptions section pour la récupération de site

La plupart des clés de la SQLConfigOptions section sont également requises pour la récupération de site. Pour plus d’informations, consultez SQLConfigOptions la section relative à l’installation de site. Le tableau suivant récapitule les clés de la section pour la SQLConfigOptions récupération de site :

Nom de la clé Requis Commentaire
SQLServerName Oui Utilisez le même serveur que celui qui hébergeait la base de données du site avant l’échec.
DatabaseName Oui Utilisez le même nom de base de données que celui utilisé avant l’échec.
SQLSSBPort Oui Utilisez le même port que celui utilisé avant l’échec.
SQLDataFilePath Non
SQLLogFilePath Non

CloudConnectorOptions section pour la récupération de site

La plupart des clés de la CloudConnectorOptions section sont également requises pour la récupération de site. Pour plus d’informations, consultez CloudConnectorOptions la section relative à l’installation de site. Le tableau suivant récapitule les clés de la section pour la CloudConnectorOptions récupération de site :

Nom de la clé Requis Commentaire
CloudConnector Oui
CloudConnectorServer Oui* * Obligatoire uniquement quand CloudConnector est égal à 1.
UseProxy Oui* * Obligatoire uniquement quand CloudConnector est égal à 1.
ProxyName Oui* * Obligatoire uniquement quand UseProxy est égal à 1.
ProxyPort Oui* * Obligatoire uniquement quand UseProxy est égal à 1.

HierarchyExpansionOption section pour la récupération de site

La plupart des clés de la HierarchyExpansionOption section sont également requises pour la récupération de site. Pour plus d’informations, consultez HierarchyExpansionOption la section relative à l’installation de site. Le tableau suivant récapitule les clés de la section pour la HierarchyExpansionOption récupération de site :

Nom de la clé Requis Commentaire
CCARSiteServer Oui* * Obligatoire uniquement si le site principal a été attaché à un site d’administration centrale avant l’échec.
CASRetryInterval Non
WaitForCASTimeout Non

Exemples

Exemple de script pour installer un site principal

[Identification]
Action=InstallPrimarySite
CDLatest=1

[Options]
ProductID=Eval
SiteCode=XYZ
SiteName=Contoso eval site
SMSInstallDir=D:\Program Files\Microsoft Configuration Manager
SDKServer=cmsite.contoso.com
PrerequisiteComp=0
PrerequisitePath=C:\Sources\Redist
AdminConsole=1
JoinCEIP=0
ManagementPoint=cmsite.contoso.com
ManagementPointProtocol=HTTP
DistributionPoint=cmsite.contoso.com
DistributionPointProtocol=HTTP
DistributionPointInstallIIS=1
RoleCommunicationProtocol=HTTPorHTTPS
ClientsUsePKICertificate=0
MobileDeviceLanguage=0

[SQLConfigOptions]
SQLServerName=cmsql.contoso.com
SQLServerPort=1433
DatabaseName=CM_XYZ
SQLSSBPort=4022
SQLDataFilePath=E:\Program Files\Microsoft SQL Server\MSSQL15.MSSQLSERVER\MSSQL\DATA\
SQLLogFilePath=E:\Program Files\Microsoft SQL Server\MSSQL15.MSSQLSERVER\MSSQL\DATA\

[CloudConnectorOptions]
CloudConnector=1
CloudConnectorServer=cmsite.contoso.com
UseProxy=0

[SABranchOptions]
SAActive=1
CurrentBranch=1