Chaves de arquivo de script de instalação autônoma
Aplica-se a: Gerenciador de Configurações (branch atual)
Este artigo define todas as chaves e valores a serem especificados no arquivo de script de .ini instalação. Use esse arquivo com a opção /SCRIPT de linha de comando para fazer uma instalação autônoma ou recuperação de um site Configuration Manager. As tabelas deste artigo mostram:
- As chaves de script de configuração disponíveis e seus valores correspondentes
- Se eles forem necessários
- Para qual tipo de instalação eles são usados
- Uma breve descrição da chave
Para saber mais, confira os seguintes artigos:
Especifique os nomes de seção em colchetes ([]): [<Section name>]. Por exemplo, [Identification].
Quando você fornece valores para chaves, o nome da chave deve ser seguido por um sinal igual (=) e o valor da chave: <Key name>=<Value>. Por exemplo, CDLatest=1. Verifique se as chaves estão na seção apropriada.
Cada seção e cada valor precisam ser exclusivos em um único script. Por exemplo, só pode haver uma [Identification] seção e apenas uma Action chave.
Ações com suporte
Um script é definido principalmente pela Action chave na Identification seção. A lista a seguir inclui todas as ações com suporte no momento para executar a instalação autônoma:
-
InstallCAS: instalar um CAS (site de administração central) -
InstallPrimarySite: instalar um site primário -
ManageLanguages: adicionar ou remover idiomas de cliente e servidor -
RecoverPrimarySite: recuperar um site primário -
RecoverCCAR: recuperar um CAS
Instalar um site
Identification seção para instalação do site
Dependendo do tipo de site que você está instalando, inclua as seguintes chaves com os valores apropriados na Identification seção:
| Nome da chave | Obrigatório | Valores | Detalhes |
|---|---|---|---|
Action |
Sim | - InstallPrimarySite- InstallCAS |
- Instalar um site primário. - Instalar um CAS (site de administração central) |
CDLatest |
Sim 2 |
1: a instalação é executada do CD.Latest |
Ao executar a configuração da CD.Latest pasta, inclua essa chave e o valor. Esse valor informa à configuração que você está usando a mídia de CD.Latest. |
Observação 2: CDLatest obrigatório
A CDLatest chave só é necessária quando você executa a instalação da CD.Latest pasta para instalar um site primário ou um site de administração central. Para obter mais informações, consulte Sobre o arquivo de script de linha de comando.
Options seção para instalação do site
Inclua as seguintes chaves na seção Opções para instalar um site:
| Nome da chave | Obrigatório | Valores | Detalhes |
|---|---|---|---|
ProductID |
Sim |
-
xxxxx-xxxxx-xxxxx-xxxxx-xxxxx: uma chave de produto válida com traços- Eval: instalar a versão de avaliação |
O tipo de licença a ser instalada. |
SiteCode |
Sim | Código de três caracteres, por exemplo XYZ |
O código do site de três caracteres que identifica exclusivamente o site na hierarquia. |
SiteName |
Sim | Um nome de site | O nome amigável para este site para ajudar a identificá-lo. |
SMSInstallDir |
Sim | Caminho do diretório local | A pasta de instalação dos arquivos do programa Configuration Manager. |
SDKServer |
Sim | FQDN do Provedor de SMS | O FQDN do primeiro servidor a hospedar o Provedor de SMS. |
PrerequisiteComp |
Sim |
-
0:Download- 1: já baixado |
Especifique se os arquivos de pré-requisito já foram baixados. Se você usar um valor de 0, a configuração baixará os arquivos. |
PrerequisitePath |
Sim | Caminho do diretório local | O caminho para os arquivos de pré-requisito. Dependendo do valor, a PrerequisiteComp configuração usa esse caminho para armazenar arquivos baixados ou para localizar arquivos baixados anteriormente. |
AdminConsole |
Sim |
-
0: não instale- 1:Instalar |
Especifique se deve instalar o console Configuration Manager no servidor do site. |
JoinCEIP |
Sim | 0 |
Embora o suporte para o CEIP (Programa de Melhoria da Experiência do Cliente) tenha sido removido do produto, essa chave ainda é necessária. |
MobileDeviceLanguage |
Sim |
-
0: não instale- 1:Instalar |
Especifique se os idiomas do cliente do dispositivo móvel estão instalados. |
Ao instalar um site, você também pode especificar as chaves para gerenciar idiomas, como AddServerLanguages ou AddClientLanguages. Para obter mais informações, consulte Options seção para idiomas.
As seguintes chaves na Options seção são específicas para um site primário:
| Nome da chave | Obrigatório | Valores | Detalhes |
|---|---|---|---|
ManagementPoint |
Não | MP FQDN | O FQDN do servidor que hospedará a função de sistema do primeiro ponto de gerenciamento (MP). |
ManagementPointProtocol |
Não |
HTTPS ou HTTP |
O protocolo a ser usado para o MP. |
DistributionPoint |
Não | DP FQDN | O FQDN do servidor que hospedará a primeira função do sistema de site do DP (ponto de distribuição). |
DistributionPointProtocol |
Não |
HTTPS ou HTTP |
O protocolo a ser usado para o DP. |
DistributionPointInstallIIS |
Não |
-
0: não instale- 1:Instalar |
Especifique se deve instalar o IIS no DP. |
RoleCommunicationProtocol |
Sim |
EnforceHTTPS ou HTTPorHTTPS |
Especifique se deve configurar todos os sistemas de site para aceitar apenas a comunicação HTTPS dos clientes ou configurar o método de comunicação para cada função do sistema de site. Quando você seleciona EnforceHTTPS, os clientes precisam de um certificado PKI (infraestrutura de chave pública) válido para autenticação do cliente. |
ClientsUsePKICertificate |
Sim |
-
0: não use- 1:Usar |
Especifique se os clientes usarão um certificado PKI do cliente para se comunicar com funções do sistema de site. |
UseFQDN |
Não |
-
0: não use- 1:Usar |
Especifique se o FQDN dos sistemas de site é para uso na Internet. |
ParentSiteCode |
Não | Código do site | Quando você estiver adicionando um site primário filho a uma hierarquia existente, especifique o código do site do CAS. |
ParentSiteServer |
Não | FQDN | Quando você estiver adicionando um site primário filho a uma hierarquia existente, especifique o FQDN do servidor CAS. |
SQLConfigOptions seção para instalação do site
Inclua as seguintes chaves na SQLConfigOptions seção para instalar um site:
| Nome da chave | Obrigatório | Valores | Detalhes |
|---|---|---|---|
SQLServerName |
Sim | FQDN de SQL Server | O nome da instância do servidor ou clusterizado que está executando SQL Server para hospedar o banco de dados do site. |
DatabaseName |
Sim | Nome ou Instance\Name |
O nome do banco de dados SQL Server para criar ou usar. Se estiver na instância padrão, especifique o nome do banco de dados. Caso contrário, especifique a instância e o nome. |
SQLServerPort |
Não | Número da porta | A porta que SQL Server usa. Por padrão, ele usa 1433. |
SQLSSBPort |
Não | Número da porta | A porta SSB (Service Broker) do SQL Server. Por padrão, o SSB usa a porta TCP 4022. |
SQLDataFilePath |
Não | Caminho do diretório local | Um local alternativo para criar o arquivo .mdb do banco de dados. |
SQLLogFilePath |
Não | Caminho do diretório local | Um local alternativo para criar o arquivo de log .ldf do banco de dados. |
AGBackupShare |
Não | Caminho do compartilhamento de rede | O local de rede para compartilhar backups de banco de dados ao criar o banco de dados do site em um Grupo de Disponibilidade. O compartilhamento de backup só será necessário se a semente automática não estiver definida. |
CloudConnectorOptions seção para instalação do site
Inclua as seguintes chaves na CloudConnectorOptions seção para instalar um site:
| Nome da chave | Obrigatório | Valores | Detalhes |
|---|---|---|---|
CloudConnector |
Sim |
-
0: não instale- 1:Instalar |
Especifique se deve instalar um SCP (ponto de conexão de serviço) neste site. Como você só pode instalar o SCP no site de camada superior de uma hierarquia, defina esse valor como para 0 um site primário filho. |
CloudConnectorServer |
Sim* | SCP FQDN | O FQDN do servidor que hospedará a função SCP. * Necessário apenas quando CloudConnector igual a 1. |
UseProxy |
Sim* |
-
0: nenhum proxy- 1: usar proxy |
Especifique se o SCP usa um servidor proxy. * Necessário apenas quando CloudConnector igual a 1. |
ProxyName |
Sim* | Proxy FQDN | O FQDN do servidor proxy que o SCP usa. * Necessário apenas quando UseProxy igual a 1. |
ProxyPort |
Sim* | Número da porta | O número da porta do servidor proxy que o SCP usa. * Necessário apenas quando UseProxy igual a 1. |
SABranchOptions seção para instalação do site
Inclua as seguintes chaves na SABranchOptions seção para instalar um site:
| Nome da chave | Obrigatório | Valores | Detalhes |
|---|---|---|---|
SAActive |
Sim |
-
0: você não tem SA- 1: SA está ativa |
Especifique se você tem SA (Software Assurance) ativo. Para obter mais informações, consulte Perguntas frequentes sobre produto e licenciamento. |
CurrentBranch |
Sim |
-
0: instalar o LTSB- 1: instalar o branch atual |
Especifique se deve usar Configuration Manager branch atual ou o LTSB (branch de manutenção de longo prazo). Para obter mais informações, consulte Qual branch de Configuration Manager devo usar? |
SAExpiration |
Não | Data | A data em que a SA expira, usada como um lembrete conveniente dessa data. Para obter mais informações, consulte Licenciamento e ramificações. |
HierarchyExpansionOption seção para expansão do site
Quando você estiver instalando um CAS para expandir um site primário autônomo em uma hierarquia, use as seguintes chaves na HierarchyExpansionOption seção:
| Nome da chave | Obrigatório | Valores | Detalhes |
|---|---|---|---|
CCARSiteServer |
Não | CAS FQDN | O FQDN do CAS ao qual um site primário anexa quando ele ingressa na hierarquia Configuration Manager. Especifique o CAS durante a instalação. |
CASRetryInterval |
Não | Minutos | Se a conexão com o CAS falhar, o site primário aguardará esse número de minutos e, em seguida, reattempta a conexão. |
WaitForCASTimeout |
Não |
0 para 100 |
O valor máximo de tempo limite em minutos para um site primário se conectar ao CAS. |
UseDistributionView |
Não |
-
0: não habilite- 1:Permitir |
Especifique se deve usar exibições distribuídas para otimizar a replicação de banco de dados. |
JoinPrimarySiteName |
Não | FQDN do servidor de site | O FQDN do servidor de site primário a ser expandido. |
Gerenciar idiomas
Identification seção para idiomas
Inclua a seguinte chave na Identification seção para gerenciar idiomas:
| Nome da chave | Obrigatório | Valores | Detalhes |
|---|---|---|---|
Action |
Sim | ManageLanguages |
Gerencia o suporte à linguagem de cliente móvel, cliente e servidor em um site. |
Options seção para idiomas
Inclua as seguintes chaves na Options seção para gerenciar idiomas:
| Nome da chave | Obrigatório | Valores | Detalhes |
|---|---|---|---|
AddServerLanguages |
Não | Confira a nota 1 | Os idiomas do servidor que estarão disponíveis para o console Configuration Manager, relatórios e outros objetos. |
AddClientLanguages |
Não | Confira a nota 1 | Os idiomas que estarão disponíveis para computadores cliente. |
DeleteServerLanguages |
Não | Confira a nota 1 | Os idiomas a serem removidos. Eles não estarão mais disponíveis para o console Configuration Manager, relatórios e outros objetos. |
DeleteClientLanguages |
Não | Confira a nota 1 | Os idiomas a serem removidos e que não estarão mais disponíveis para computadores cliente. O inglês está disponível por padrão, você não pode removê-lo. |
MobileDeviceLanguage |
Sim |
-
0: não instale- 1:Instalar |
Especifique se os idiomas do cliente do dispositivo móvel estão instalados. |
PrerequisiteComp |
Sim |
-
0:Download- 1: já baixado |
Especifique se os arquivos de pré-requisito já foram baixados. Por exemplo, se você usar um valor de 0, a configuração baixará os arquivos. |
PrerequisitePath |
Sim | Caminho do diretório local | O caminho para os arquivos de pré-requisito. Dependendo do valor, a PrerequisiteComp configuração usa esse caminho para armazenar arquivos baixados ou para localizar arquivos baixados anteriormente. |
ResetSecSiteLangs |
Não |
-
0: não redefinir- 1:Redefinir |
Redefina os pacotes de idioma instalados em um site secundário. |
Observação 1: Valores de linguagem com suporte
Use o código de três letras para os idiomas do servidor ou idiomas do cliente que Configuration Manager dá suporte. Por exemplo, para adicionar suporte ao alemão no cliente, especifique a seguinte chave e par de valores: AddClientLanguages=DEU
O inglês (ENG) está disponível por padrão. Você não precisa adicioná-lo e não pode removê-lo.
Recuperar um site
Identification seção para recuperação de site
Dependendo do tipo de site que você está recuperando, inclua as seguintes chaves com os valores apropriados na Identification seção:
| Nome da chave | Obrigatório | Valores | Detalhes |
|---|---|---|---|
Action |
Sim | - RecoverPrimarySite- RecoverCCAR |
- Recuperar um site primário - Recuperar um CAS |
CDLatest |
Sim 3 |
1: a instalação é executada do CD.Latest |
Ao executar a configuração da pasta CD.Latest, inclua essa chave e o valor. Esse valor informa à configuração que você está usando a mídia do CD.Latest. |
Observação 3: CDLatest obrigatório
A CDLatest chave só é necessária quando você executa a configuração da CD.Latest pasta para recuperar um site. Para obter mais informações, consulte Sobre o arquivo de script de linha de comando.
RecoveryOptions seção para recuperação de site
Inclua as seguintes chaves na RecoveryOptions seção para recuperar um site:
| Nome da chave | Obrigatório | Valores | Detalhes |
|---|---|---|---|
ServerRecoveryOptions |
Sim |
-
1: servidor de site e SQL Server- 2: somente servidor de site- 4: somente SQL Server |
Quais componentes recuperar. Confira a nota 4 |
DatabaseRecoveryOptions |
Sim* |
-
10: Restauração do backup- 20: recuperado manualmente- 40: criar um novo banco de dados- 80:Ignorar |
Especifique como a instalação recupera o banco de dados do site no SQL Server. * Necessário apenas quando ServerRecoveryOptions for 1 ou 4. |
ReferenceSite |
Sim* | FQDN | O site primário de referência que o CAS usa para recuperar dados globais. * Necessário apenas quando DatabaseRecoveryOptions for 40.
Confira a nota 5 |
SiteServerBackupLocation |
Não | Caminho do diretório | O caminho para o conjunto de backup do servidor do site. Se você não especificar um valor, a instalação reinstalará o site sem restaurá-lo de um conjunto de backup. |
BackupLocation |
Sim* | Caminho do diretório | O caminho para o conjunto de backup do banco de dados do site. * Obrigatório quando ServerRecoveryOptions é 1 ou 4, e DatabaseRecoveryOptions é 10. |
Observação 4: ServerRecoveryOptions notas de valor
1ou2: para recuperar o site usando um backup de site, especifique um valor paraSiteServerBackupLocation. Se você não especificar um valor, a instalação reinstalará o site sem restaurá-lo de um conjunto de backup.4: aBackupLocationchave é necessária quando você configura um valor da10para aDatabaseRecoveryOptionschave, que é restaurar o banco de dados do site do backup.
Observação 5: ReferenceSite notas de valor
Se o backup do banco de dados for mais antigo do que o período de retenção de rastreamento de alterações ou quando você recuperar o site sem um backup, especifique o site primário de referência que o CAS usa para recuperar dados globais.
Quando você não especifica um site de referência e o backup é mais antigo que o período de retenção de rastreamento de alterações, todos os sites primários são reinitializados com os dados restaurados do CAS.
Quando você não especifica um site de referência e o backup está dentro do período de retenção de rastreamento de alterações, somente as alterações feitas após o backup são replicadas de sites primários. Quando há alterações conflitantes de sites primários diferentes, o CAS usa o primeiro que recebe.
Options seção para recuperação de site
Muitas das chaves na Options seção também são necessárias para a recuperação do site. Para obter mais informações, consulte Options seção para instalação do site. A tabela a seguir resume as chaves na seção para recuperação do Options site:
| Nome da chave | Obrigatório | Comentário |
|---|---|---|
ProductID |
Sim | |
SiteCode |
Sim | Use o mesmo código de site usado antes da falha. |
SiteName |
Não | |
SMSInstallDir |
Sim | |
SDKServer |
Sim | Use o mesmo servidor que hospedou essa função antes da falha. |
PrerequisiteComp |
Sim | |
PrerequisitePath |
Sim | |
AdminConsole |
Sim* | * Necessário apenas quando ServerRecoveryOptions for 1 ou 2. |
JoinCEIP |
Sim |
SQLConfigOptions seção para recuperação de site
Muitas das chaves na SQLConfigOptions seção também são necessárias para a recuperação do site. Para obter mais informações, consulte SQLConfigOptions seção para instalação do site. A tabela a seguir resume as chaves na seção para recuperação do SQLConfigOptions site:
| Nome da chave | Obrigatório | Comentário |
|---|---|---|
SQLServerName |
Sim | Use o mesmo servidor que hospedou o banco de dados do site antes da falha. |
DatabaseName |
Sim | Use o mesmo nome de banco de dados que foi usado antes da falha. |
SQLSSBPort |
Sim | Use a mesma porta usada antes da falha. |
SQLDataFilePath |
Não | |
SQLLogFilePath |
Não |
CloudConnectorOptions seção para recuperação de site
Muitas das chaves na CloudConnectorOptions seção também são necessárias para a recuperação do site. Para obter mais informações, consulte CloudConnectorOptions seção para instalação do site. A tabela a seguir resume as chaves na seção para recuperação do CloudConnectorOptions site:
| Nome da chave | Obrigatório | Comentário |
|---|---|---|
CloudConnector |
Sim | |
CloudConnectorServer |
Sim* | * Necessário apenas quando CloudConnector igual a 1. |
UseProxy |
Sim* | * Necessário apenas quando CloudConnector igual a 1. |
ProxyName |
Sim* | * Necessário apenas quando UseProxy igual a 1. |
ProxyPort |
Sim* | * Necessário apenas quando UseProxy igual a 1. |
HierarchyExpansionOption seção para recuperação de site
Muitas das chaves na HierarchyExpansionOption seção também são necessárias para a recuperação do site. Para obter mais informações, consulte HierarchyExpansionOption seção para instalação do site. A tabela a seguir resume as chaves na seção para recuperação do HierarchyExpansionOption site:
| Nome da chave | Obrigatório | Comentário |
|---|---|---|
CCARSiteServer |
Sim* | * Necessário somente se o site primário foi anexado a um CAS antes da falha. |
CASRetryInterval |
Não | |
WaitForCASTimeout |
Não |
Exemplos
Script de exemplo para instalar um site primário
[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