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 |
Sì | - InstallPrimarySite- InstallCAS |
- Installare un sito primario. - Installare un sito di amministrazione centrale |
CDLatest |
Sì 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 |
Sì |
-
xxxxx-xxxxx-xxxxx-xxxxx-xxxxx: codice Product Key valido con trattino- Eval: installare la versione di valutazione |
Tipo di licenza da installare. |
SiteCode |
Sì | Codice di tre caratteri, ad esempio XYZ |
Codice del sito a tre caratteri che identifica in modo univoco il sito nella gerarchia. |
SiteName |
Sì | Nome di un sito | Nome descrittivo per questo sito che consente di identificarlo. |
SMSInstallDir |
Sì | Percorso della directory locale | Cartella di installazione per i file di programma Configuration Manager. |
SDKServer |
Sì | SMS Provider FQDN | FQDN del primo server in cui ospitare il provider SMS. |
PrerequisiteComp |
Sì |
-
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 |
Sì | 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 |
Sì |
-
0: non installare- 1:Installare |
Specificare se installare la console Configuration Manager nel server del sito. |
JoinCEIP |
Sì | 0 |
Anche se il supporto per il programma Analisi utilizzo software è stato rimosso dal prodotto, questa chiave è ancora necessaria. |
MobileDeviceLanguage |
Sì |
-
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 |
Sì |
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 |
Sì |
-
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 |
Sì | FQDN di SQL Server | Nome del server o dell'istanza cluster in esecuzione SQL Server per ospitare il database del sito. |
DatabaseName |
Sì | 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 |
Sì |
-
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 |
Sì |
-
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 |
Sì |
-
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 |
Sì | 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 |
Sì |
-
0: non installare- 1:Installare |
Specificare se sono installate le lingue client dei dispositivi mobili. |
PrerequisiteComp |
Sì |
-
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 |
Sì | 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 |
Sì | - RecoverPrimarySite- RecoverCCAR |
- Ripristinare un sito primario - Ripristinare un cas |
CDLatest |
Sì 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 |
Sì |
-
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
1o2: per ripristinare il sito usando un backup del sito, specificare un valore perSiteServerBackupLocation. Se non si specifica un valore, il programma di installazione reinstalla il sito senza ripristinarlo da un set di backup.4: laBackupLocationchiave è necessaria quando si configura un valore di10per laDatabaseRecoveryOptionschiave, 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 |
Sì | |
SiteCode |
Sì | Usare lo stesso codice del sito usato prima dell'errore. |
SiteName |
No | |
SMSInstallDir |
Sì | |
SDKServer |
Sì | Usare lo stesso server che ha ospitato questo ruolo prima dell'errore. |
PrerequisiteComp |
Sì | |
PrerequisitePath |
Sì | |
AdminConsole |
Sì* | * Obbligatorio solo quando ServerRecoveryOptions è 1 o 2. |
JoinCEIP |
Sì |
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 |
Sì | Usare lo stesso server che ospitava il database del sito prima dell'errore. |
DatabaseName |
Sì | Usare lo stesso nome di database usato prima dell'errore. |
SQLSSBPort |
Sì | 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 |
Sì | |
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