Condividi tramite


Chiavi del file di script di installazione automatica

Si applica a: Configuration Manager (Current Branch)

Questo articolo definisce tutte le chiavi e i valori da specificare nel file di script di .ini installazione. Usare questo file con l'opzione della /SCRIPT riga di comando per eseguire un'installazione automatica o il ripristino di un sito Configuration Manager. Le tabelle in questo articolo illustrano:

  • Le chiavi script di installazione disponibili e i relativi valori corrispondenti
  • Se sono necessari
  • Quale tipo di installazione vengono usati per
  • Breve descrizione della chiave

Per altre informazioni, vedere gli articoli seguenti:

Specificare i nomi delle sezioni tra parentesi quadre ([]): [<Section name>]. Ad esempio, [Identification].

Quando si specificano valori per le chiavi, il nome della chiave deve essere seguito da un segno di uguale (=) e dal valore per la chiave: <Key name>=<Value>. Ad esempio, CDLatest=1. Assicurarsi che le chiavi si trovino nella sezione appropriata.

Ogni sezione e ogni valore devono essere univoci in un singolo script. Ad esempio, può essere presente una [Identification] sola sezione e una Action sola chiave.

Azioni supportate

Uno script viene definito principalmente dalla Action chiave nella Identification sezione . L'elenco seguente include tutte le azioni attualmente supportate per l'esecuzione automatica dell'installazione:

  • InstallCAS: installare un sito di amministrazione centrale (CAS)
  • InstallPrimarySite: installare un sito primario
  • ManageLanguages: aggiungere o rimuovere lingue client e server
  • RecoverPrimarySite: ripristino di un sito primario
  • RecoverCCAR: ripristinare un cas

Installare un sito

Identification sezione per l'installazione del sito

A seconda del tipo di sito che si sta installando, includere le chiavi seguenti con i valori appropriati nella Identification sezione :

Nome chiave Obbligatorio Valori Dettagli
Action InstallPrimarySite
InstallCAS
- Installare un sito primario.
- Installare un sito di amministrazione centrale
CDLatest 2 1: il programma di installazione viene eseguito da CD.Latest Quando si esegue il programma di installazione dalla CD.Latest cartella, includere questa chiave e questo valore. Questo valore indica al programma di installazione che si sta usando il supporto di CD.Latest.

Nota 2: CDLatest obbligatorio

La CDLatest chiave è necessaria solo quando si esegue il CD.Latest programma di installazione dalla cartella per installare un sito primario o un sito di amministrazione centrale. Per altre informazioni, vedere Informazioni sul file di script della riga di comando.

Options sezione per l'installazione del sito

Includere le chiavi seguenti nella sezione Opzioni per installare un sito:

Nome chiave Obbligatorio Valori Dettagli
ProductID xxxxx-xxxxx-xxxxx-xxxxx-xxxxx: codice Product Key valido con trattino
Eval: installare la versione di valutazione
Tipo di licenza da installare.
SiteCode Codice di tre caratteri, ad esempio XYZ Codice del sito a tre caratteri che identifica in modo univoco il sito nella gerarchia.
SiteName Nome di un sito Nome descrittivo per questo sito che consente di identificarlo.
SMSInstallDir Percorso della directory locale Cartella di installazione per i file di programma Configuration Manager.
SDKServer SMS Provider FQDN FQDN del primo server in cui ospitare il provider SMS.
PrerequisiteComp - 0:Scaricare
- 1: già scaricato
Specificare se i file dei prerequisiti sono già stati scaricati. Se si usa un valore di , il programma di 0installazione scarica i file.
PrerequisitePath Percorso della directory locale Percorso dei file dei prerequisiti. A seconda del valore, il PrerequisiteComp programma di installazione usa questo percorso per archiviare i file scaricati o per individuare i file scaricati in precedenza.
AdminConsole - 0: non installare
- 1:Installare
Specificare se installare la console Configuration Manager nel server del sito.
JoinCEIP 0 Anche se il supporto per il programma Analisi utilizzo software è stato rimosso dal prodotto, questa chiave è ancora necessaria.
MobileDeviceLanguage - 0: non installare
- 1:Installare
Specificare se sono installate le lingue client dei dispositivi mobili.

Quando si installa un sito, è anche possibile specificare le chiavi per gestire le lingue, ad AddServerLanguages esempio o AddClientLanguages. Per altre informazioni, vedere laOptions sezione relativa alle lingue.

Le chiavi seguenti nella Options sezione sono specifiche di un sito primario:

Nome chiave Obbligatorio Valori Dettagli
ManagementPoint No MP FQDN FQDN del server che ospiterà il primo ruolo del sistema del sito del punto di gestione (MP).
ManagementPointProtocol No HTTPS o HTTP Protocollo da usare per mp.
DistributionPoint No DP FQDN FQDN del server che ospiterà il primo ruolo del sistema del sito del punto di distribuzione (DP).
DistributionPointProtocol No HTTPS o HTTP Protocollo da usare per il protocollo DP.
DistributionPointInstallIIS No - 0: non installare
- 1:Installare
Specificare se installare IIS in DP.
RoleCommunicationProtocol EnforceHTTPS o HTTPorHTTPS Specificare se configurare tutti i sistemi del sito in modo che accettino solo le comunicazioni HTTPS dai client o per configurare il metodo di comunicazione per ogni ruolo del sistema del sito. Quando si seleziona EnforceHTTPS, i client necessitano di un certificato PKI (Public Key Infrastructure) valido per l'autenticazione client.
ClientsUsePKICertificate - 0: non usare
- 1:Utilizzare
Specificare se i client useranno un certificato PKI client per comunicare con i ruoli del sistema del sito.
UseFQDN No - 0: non usare
- 1:Utilizzare
Specificare se l'FQDN dei sistemi del sito è destinato all'uso su Internet.
ParentSiteCode No Codice del sito Quando si aggiunge un sito primario figlio a una gerarchia esistente, specificare il codice del sito del sito cas.
ParentSiteServer No FQDN Quando si aggiunge un sito primario figlio a una gerarchia esistente, specificare il nome di dominio completo del server CAS.

SQLConfigOptions sezione per l'installazione del sito

Includere le chiavi seguenti nella SQLConfigOptions sezione per installare un sito:

Nome chiave Obbligatorio Valori Dettagli
SQLServerName FQDN di SQL Server Nome del server o dell'istanza cluster in esecuzione SQL Server per ospitare il database del sito.
DatabaseName Nome o
Istanza\Nome
Nome del database SQL Server da creare o usare. Se si tratta dell'istanza predefinita, è sufficiente specificare il nome del database. In caso contrario, specificare l'istanza e il nome.
SQLServerPort No Numero di porta Porta usata SQL Server. Per impostazione predefinita, usa 1433.
SQLSSBPort No Numero di porta Porta SQL Server Service Broker (SSB). Per impostazione predefinita, SSB usa la porta TCP 4022.
SQLDataFilePath No Percorso della directory locale Percorso alternativo per creare il file con estensione mdb del database.
SQLLogFilePath No Percorso della directory locale Percorso alternativo per creare il file di log con estensione ldf del database.
AGBackupShare No Percorso di condivisione di rete Percorso di rete per la condivisione dei backup del database durante la creazione del database del sito in un gruppo di disponibilità. La condivisione di backup è necessaria solo se il seeding automatico non è impostato.

CloudConnectorOptions sezione per l'installazione del sito

Includere le chiavi seguenti nella CloudConnectorOptions sezione per installare un sito:

Nome chiave Obbligatorio Valori Dettagli
CloudConnector - 0: non installare
- 1:Installare
Specificare se installare un punto di connessione del servizio (SCP) in questo sito. Poiché è possibile installare SCP solo nel sito di livello superiore di una gerarchia, impostare questo valore 0 su per un sito primario figlio.
CloudConnectorServer Sì* SCP FQDN FQDN del server che ospiterà il ruolo SCP. * Obbligatorio solo quando CloudConnector è uguale a 1.
UseProxy Sì* - 0: nessun proxy
- 1: usare il proxy
Specificare se SCP usa un server proxy. * Obbligatorio solo quando CloudConnector è uguale a 1.
ProxyName Sì* Proxy FQDN FQDN del server proxy usato da SCP. * Obbligatorio solo quando UseProxy è uguale a 1.
ProxyPort Sì* Numero di porta Numero di porta del server proxy usato da SCP. * Obbligatorio solo quando UseProxy è uguale a 1.

SABranchOptions sezione per l'installazione del sito

Includere le chiavi seguenti nella SABranchOptions sezione per installare un sito:

Nome chiave Obbligatorio Valori Dettagli
SAActive - 0: non si dispone di sa
- 1: L'sa è attiva
Specificare se si dispone di Software Assurance (SA) attivo. Per altre informazioni, vedere Domande frequenti sul prodotto e sulle licenze.
CurrentBranch - 0: installare LTSB
- 1: Installare Current Branch
Specificare se usare Configuration Manager current branch o long-term servicing branch (LTSB). Per altre informazioni, vedere Quale ramo di Configuration Manager è consigliabile usare?
SAExpiration No Data Data di scadenza dell'sa, usata come comodo promemoria di tale data. Per altre informazioni, vedere Licenze e rami.

HierarchyExpansionOption sezione per l'espansione del sito

Quando si installa un sito cas per espandere un sito primario autonomo in una gerarchia, usare le chiavi seguenti nella HierarchyExpansionOption sezione :

Nome chiave Obbligatorio Valori Dettagli
CCARSiteServer No CAS FQDN FQDN del sito cas a cui si collega un sito primario quando aggiunge la gerarchia Configuration Manager. Specificare il server di amministrazione centrale durante l'installazione.
CASRetryInterval No Minuti Se la connessione al sito cas ha esito negativo, il sito primario attende questo numero di minuti e quindi ritenta la connessione.
WaitForCASTimeout No Da 0 a 100 Valore di timeout massimo in minuti per la connessione di un sito primario al server di amministrazione centrale.
UseDistributionView No - 0: non abilitare
- 1:Attivare
Specificare se usare le viste distribuite per ottimizzare la replica del database.
JoinPrimarySiteName No FQDN del server del sito FQDN del server del sito primario da espandere.

Gestire le lingue

Identification sezione per le lingue

Includere la chiave seguente nella Identification sezione per gestire le lingue:

Nome chiave Obbligatorio Valori Dettagli
Action ManageLanguages Gestisce il supporto della lingua client per server, client e dispositivi mobili in un sito.

Options sezione per le lingue

Includere le chiavi seguenti nella Options sezione per gestire le lingue:

Nome chiave Obbligatorio Valori Dettagli
AddServerLanguages No Vedere la nota 1 Lingue del server che saranno disponibili per la console di Configuration Manager, i report e altri oggetti.
AddClientLanguages No Vedere la nota 1 Lingue che saranno disponibili per i computer client.
DeleteServerLanguages No Vedere la nota 1 Lingue da rimuovere. Non saranno più disponibili per la console Configuration Manager, i report e altri oggetti.
DeleteClientLanguages No Vedere la nota 1 Lingue da rimuovere e che non saranno più disponibili per i computer client. L'inglese è disponibile per impostazione predefinita, non è possibile rimuoverlo.
MobileDeviceLanguage - 0: non installare
- 1:Installare
Specificare se sono installate le lingue client dei dispositivi mobili.
PrerequisiteComp - 0:Scaricare
- 1: già scaricato
Specificare se i file dei prerequisiti sono già stati scaricati. Ad esempio, se si usa un valore di , il programma di 0installazione scarica i file.
PrerequisitePath Percorso della directory locale Percorso dei file dei prerequisiti. A seconda del valore, il PrerequisiteComp programma di installazione usa questo percorso per archiviare i file scaricati o per individuare i file scaricati in precedenza.
ResetSecSiteLangs No - 0: non reimpostare
- 1:Reimpostare
Reimpostare i Language Pack installati in un sito secondario.

Nota 1: Valori di lingua supportati

Usare il codice di tre lettere per le lingue server o client supportate da Configuration Manager. Ad esempio, per aggiungere il supporto per il tedesco nel client, specificare la coppia chiave-valore seguente: AddClientLanguages=DEU

L'inglese (ENG) è disponibile per impostazione predefinita. Non è necessario aggiungerlo e non è possibile rimuoverlo.

Ripristinare un sito

Identification sezione per site recovery

A seconda del tipo di sito in fase di ripristino, includere le chiavi seguenti con i valori appropriati nella Identification sezione :

Nome chiave Obbligatorio Valori Dettagli
Action RecoverPrimarySite
RecoverCCAR
- Ripristinare un sito primario
- Ripristinare un cas
CDLatest 3 1: il programma di installazione viene eseguito da CD.Latest Quando si esegue il programma di installazione dalla cartella CD.Latest, includere questa chiave e questo valore. Questo valore indica al programma di installazione che si sta usando il supporto di CD.Latest.

Nota 3: CDLatest obbligatorio

La CDLatest chiave è necessaria solo quando si esegue il programma di installazione dalla CD.Latest cartella per ripristinare un sito. Per altre informazioni, vedere Informazioni sul file di script della riga di comando.

RecoveryOptions sezione per site recovery

Includere le chiavi seguenti nella RecoveryOptions sezione per ripristinare un sito:

Nome chiave Obbligatorio Valori Dettagli
ServerRecoveryOptions - 1: server del sito e SQL Server
- 2: solo server del sito
- 4: solo SQL Server
Componenti da ripristinare. Vedere la nota 4
DatabaseRecoveryOptions Sì* - 10: ripristino dal backup
- 20: ripristinato manualmente
- 40: creare un nuovo database
- 80:Saltare
Specificare la modalità di ripristino del database del sito in SQL Server. * Obbligatorio solo quando ServerRecoveryOptions è 1 o 4.
ReferenceSite Sì* FQDN Sito primario di riferimento usato dal server di amministrazione centrale per ripristinare i dati globali. * Obbligatorio solo quando DatabaseRecoveryOptions è 40. Vedere la nota 5
SiteServerBackupLocation No Percorso della directory Percorso del set di backup del server del sito. Se non si specifica un valore, il programma di installazione reinstalla il sito senza ripristinarlo da un set di backup.
BackupLocation Sì* Percorso della directory Percorso del set di backup del database del sito. * Obbligatorio quando ServerRecoveryOptions è 1 o 4e DatabaseRecoveryOptions è 10.

Nota 4: ServerRecoveryOptions note sul valore

  • 1 o 2: per ripristinare il sito usando un backup del sito, specificare un valore per SiteServerBackupLocation. Se non si specifica un valore, il programma di installazione reinstalla il sito senza ripristinarlo da un set di backup.

  • 4: la BackupLocation chiave è necessaria quando si configura un valore di 10 per la DatabaseRecoveryOptions chiave, ovvero per ripristinare il database del sito dal backup.

Nota 5: ReferenceSite note sul valore

  • Se il backup del database è precedente al periodo di conservazione del rilevamento delle modifiche o quando si ripristina il sito senza un backup, specificare il sito primario di riferimento usato dal sito di amministrazione centrale per ripristinare i dati globali.

  • Quando non si specifica un sito di riferimento e il backup è precedente al periodo di conservazione del rilevamento delle modifiche, tutti i siti primari vengono reinizializzati con i dati ripristinati dal cas.

  • Quando non si specifica un sito di riferimento e il backup rientra nel periodo di conservazione del rilevamento delle modifiche, solo le modifiche apportate dopo la replica del backup dai siti primari. In caso di modifiche in conflitto da siti primari diversi, il sito di amministrazione centrale usa il primo che riceve.

Options sezione per site recovery

Molte delle chiavi nella Options sezione sono necessarie anche per il ripristino del sito. Per altre informazioni, vedere laOptions sezione relativa all'installazione del sito. La tabella seguente riepiloga le chiavi nella Options sezione per site recovery:

Nome chiave Obbligatorio Comment
ProductID
SiteCode Usare lo stesso codice del sito usato prima dell'errore.
SiteName No
SMSInstallDir
SDKServer Usare lo stesso server che ha ospitato questo ruolo prima dell'errore.
PrerequisiteComp
PrerequisitePath
AdminConsole Sì* * Obbligatorio solo quando ServerRecoveryOptions è 1 o 2.
JoinCEIP

SQLConfigOptions sezione per site recovery

Molte delle chiavi nella SQLConfigOptions sezione sono necessarie anche per il ripristino del sito. Per altre informazioni, vedere laSQLConfigOptions sezione relativa all'installazione del sito. La tabella seguente riepiloga le chiavi nella SQLConfigOptions sezione per site recovery:

Nome chiave Obbligatorio Comment
SQLServerName Usare lo stesso server che ospitava il database del sito prima dell'errore.
DatabaseName Usare lo stesso nome di database usato prima dell'errore.
SQLSSBPort Usare la stessa porta usata prima dell'errore.
SQLDataFilePath No
SQLLogFilePath No

CloudConnectorOptions sezione per site recovery

Molte delle chiavi nella CloudConnectorOptions sezione sono necessarie anche per il ripristino del sito. Per altre informazioni, vedere laCloudConnectorOptions sezione relativa all'installazione del sito. La tabella seguente riepiloga le chiavi nella CloudConnectorOptions sezione per site recovery:

Nome chiave Obbligatorio Comment
CloudConnector
CloudConnectorServer Sì* * Obbligatorio solo quando CloudConnector è uguale a 1.
UseProxy Sì* * Obbligatorio solo quando CloudConnector è uguale a 1.
ProxyName Sì* * Obbligatorio solo quando UseProxy è uguale a 1.
ProxyPort Sì* * Obbligatorio solo quando UseProxy è uguale a 1.

HierarchyExpansionOption sezione per site recovery

Molte delle chiavi nella HierarchyExpansionOption sezione sono necessarie anche per il ripristino del sito. Per altre informazioni, vedere laHierarchyExpansionOption sezione relativa all'installazione del sito. La tabella seguente riepiloga le chiavi nella HierarchyExpansionOption sezione per site recovery:

Nome chiave Obbligatorio Comment
CCARSiteServer Sì* * Obbligatorio solo se il sito primario è stato collegato a un cas prima dell'errore.
CASRetryInterval No
WaitForCASTimeout No

Esempi

Script di esempio per installare un sito primario

[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