Compartir vía


Claves de archivo de script de instalación desatendida

Se aplica a: Configuration Manager (rama actual)

En este artículo se definen todas las claves y valores que se especifican en el archivo de .ini script de instalación. Use este archivo con la /SCRIPT opción de línea de comandos para realizar una instalación o recuperación desatendida de un sitio de Configuration Manager. Las tablas de este artículo muestran:

  • Las claves de script de instalación disponibles y sus valores correspondientes
  • Si son necesarias
  • ¿Para qué tipo de instalación se usan?
  • Una breve descripción de la clave

Para más información, consulte los siguientes artículos:

Especifique los nombres de sección entre corchetes ([]): [<Section name>]. Por ejemplo, [Identification].

Cuando se proporcionan valores para las claves, el nombre de la clave debe ir seguido de un signo igual (=) y el valor de la clave: <Key name>=<Value>. Por ejemplo, CDLatest=1. Asegúrese de que las claves están en la sección adecuada.

Cada sección y cada valor deben ser únicos en un único script. Por ejemplo, solo puede haber una [Identification] sección y solo una Action clave.

Acciones admitidas

La clave de la ActionIdentification sección define principalmente un script. En la lista siguiente se incluyen todas las acciones admitidas actualmente para ejecutar la instalación desatendida:

  • InstallCAS: instalar un sitio de administración central (CAS)
  • InstallPrimarySite: instalar un sitio primario
  • ManageLanguages: agregar o quitar idiomas de cliente y servidor
  • RecoverPrimarySite: recuperación de un sitio primario
  • RecoverCCAR: recuperación de un CAS

Instalación de un sitio

Identification sección para la instalación del sitio

En función del tipo de sitio que esté instalando, incluya las claves siguientes con los valores adecuados en la Identification sección:

Nombre de clave Obligatorio Valores Detalles
Action Yes InstallPrimarySite
InstallCAS
- Instalar un sitio primario.
- Instalación de un sitio de administración central (CAS)
CDLatest 2 1: el programa de instalación se ejecuta desde CD.Latest Cuando ejecute el programa de instalación desde la CD.Latest carpeta, incluya esta clave y valor. Este valor indica al programa de instalación que está usando medios de CD.Latest.

Nota 2: CDLatest Obligatorio

La CDLatest clave solo es necesaria cuando se ejecuta el programa de instalación desde la CD.Latest carpeta para instalar un sitio primario o un sitio de administración central. Para obtener más información, vea Acerca del archivo de script de línea de comandos.

Options sección para la instalación del sitio

Incluya las claves siguientes en la sección Opciones para instalar un sitio:

Nombre de clave Obligatorio Valores Detalles
ProductID Yes xxxxx-xxxxx-xxxxx-xxxxx-xxxxx: una clave de producto válida con guiones
Eval: instale la versión de evaluación.
Tipo de licencia que se va a instalar.
SiteCode Yes Código de tres caracteres, por ejemplo XYZ Código de sitio de tres caracteres que identifica de forma única el sitio de la jerarquía.
SiteName Yes Un nombre de sitio Nombre descriptivo de este sitio para ayudar a identificarlo.
SMSInstallDir Yes Ruta de acceso del directorio local Carpeta de instalación de los archivos de programa Configuration Manager.
SDKServer Yes FQDN del proveedor de SMS FQDN del primer servidor que hospeda el proveedor de SMS.
PrerequisiteComp Yes - 0:Descargar
- 1: ya descargado
Especifique si los archivos de requisitos previos ya se han descargado. Si usa un valor de , el programa de 0instalación descarga los archivos.
PrerequisitePath Yes Ruta de acceso del directorio local Ruta de acceso a los archivos de requisitos previos. En función del valor, el PrerequisiteComp programa de instalación usa esta ruta de acceso para almacenar los archivos descargados o para localizar los archivos descargados anteriormente.
AdminConsole Yes - 0: no se instala
- 1:Instalar
Especifique si desea instalar la consola de Configuration Manager en el servidor de sitio.
JoinCEIP Yes 0 Aunque se quitó el soporte técnico para el Programa para la mejora de la experiencia del cliente (CEIP) del producto, esta clave sigue siendo necesaria.
MobileDeviceLanguage Yes - 0: no se instala
- 1:Instalar
Especifique si están instalados los idiomas de cliente del dispositivo móvil.

Al instalar un sitio, también puede especificar las claves para administrar idiomas, como AddServerLanguages o AddClientLanguages. Para obtener más información, consulte Options la sección de idiomas.

Las claves siguientes de la Options sección son específicas de un sitio primario:

Nombre de clave Obligatorio Valores Detalles
ManagementPoint No MP FQDN FqdN del servidor que hospedará el primer rol de sistema de sitio de punto de administración (MP).
ManagementPointProtocol No HTTPS o HTTP Protocolo que se va a usar para el mp.
DistributionPoint No DP FQDN FQDN del servidor que hospedará el primer rol de sistema de sitio de punto de distribución (DP).
DistributionPointProtocol No HTTPS o HTTP Protocolo que se va a usar para el DP.
DistributionPointInstallIIS No - 0: no se instala
- 1:Instalar
Especifique si se va a instalar IIS en el DP.
RoleCommunicationProtocol Yes EnforceHTTPS o HTTPorHTTPS Especifique si desea configurar todos los sistemas de sitio para que acepten solo la comunicación HTTPS de los clientes o para configurar el método de comunicación para cada rol de sistema de sitio. Al seleccionar EnforceHTTPS, los clientes necesitan un certificado de infraestructura de clave pública (PKI) válido para la autenticación de cliente.
ClientsUsePKICertificate Yes - 0: no usar
- 1:Uso
Especifique si los clientes usarán un certificado PKI de cliente para comunicarse con roles de sistema de sitio.
UseFQDN No - 0: no usar
- 1:Uso
Especifique si el FQDN de los sistemas de sitio está para su uso en Internet.
ParentSiteCode No Código del sitio Al agregar un sitio primario secundario a una jerarquía existente, especifique el código de sitio del CAS.
ParentSiteServer No FQDN Al agregar un sitio primario secundario a una jerarquía existente, especifique el FQDN del servidor CAS.

SQLConfigOptions sección para la instalación del sitio

Incluya las claves siguientes en la SQLConfigOptions sección para instalar un sitio:

Nombre de clave Obligatorio Valores Detalles
SQLServerName Yes FQDN de SQL Server El nombre del servidor o la instancia en clúster que ejecuta SQL Server para hospedar la base de datos del sitio.
DatabaseName Yes Nombre o
Instance\Name
Nombre de la base de datos de SQL Server que se va a crear o usar. Si está en la instancia predeterminada, especifique el nombre de la base de datos. De lo contrario, especifique la instancia y el nombre.
SQLServerPort No Número de puerto Puerto que SQL Server usa. De forma predeterminada, usa 1433.
SQLSSBPort No Número de puerto Puerto SQL Server Service Broker (SSB). De forma predeterminada, SSB usa el puerto TCP 4022.
SQLDataFilePath No Ruta de acceso del directorio local Ubicación alternativa para crear el archivo .mdb de la base de datos.
SQLLogFilePath No Ruta de acceso del directorio local Ubicación alternativa para crear el archivo de registro .ldf de la base de datos.
AGBackupShare No Ruta de acceso del recurso compartido de red Ubicación de red para compartir copias de seguridad de base de datos al crear la base de datos de sitio en un grupo de disponibilidad. El recurso compartido de copia de seguridad solo es necesario si no se establece la propagación automática.

CloudConnectorOptions sección para la instalación del sitio

Incluya las claves siguientes en la CloudConnectorOptions sección para instalar un sitio:

Nombre de clave Obligatorio Valores Detalles
CloudConnector Yes - 0: no se instala
- 1:Instalar
Especifique si desea instalar un punto de conexión de servicio (SCP) en este sitio. Dado que solo puede instalar el SCP en el sitio de nivel superior de una jerarquía, establezca este valor 0 en para un sitio primario secundario.
CloudConnectorServer Sí* SCP FQDN FQDN del servidor que hospedará el rol SCP. * Solo se requiere cuando CloudConnector es igual a 1.
UseProxy Sí* - 0: sin proxy
- 1: use el proxy
Especifique si scp usa un servidor proxy. * Solo se requiere cuando CloudConnector es igual a 1.
ProxyName Sí* Proxy FQDN FQDN del servidor proxy que usa SCP. * Solo se requiere cuando UseProxy es igual a 1.
ProxyPort Sí* Número de puerto Número de puerto del servidor proxy que usa SCP. * Solo se requiere cuando UseProxy es igual a 1.

SABranchOptions sección para la instalación del sitio

Incluya las claves siguientes en la SABranchOptions sección para instalar un sitio:

Nombre de clave Obligatorio Valores Detalles
SAActive Yes - 0: no tiene SA
- 1: SA está activo
Especifique si tiene Software Assurance (SA) activo. Para obtener más información, consulte Preguntas más frecuentes sobre productos y licencias.
CurrentBranch Yes - 0: instale el LTSB.
- 1: instale la rama actual.
Especifique si se va a usar Configuration Manager rama actual o rama de mantenimiento a largo plazo (LTSB). Para obtener más información, consulte ¿Qué rama de Configuration Manager debo usar?
SAExpiration No Fecha Fecha en la que expira SA, que se usa como recordatorio práctico de esa fecha. Para obtener más información, consulte Licencias y ramas.

HierarchyExpansionOption sección para la expansión del sitio

Al instalar un CAS para expandir un sitio primario independiente en una jerarquía, use las claves siguientes en la HierarchyExpansionOption sección :

Nombre de clave Obligatorio Valores Detalles
CCARSiteServer No CAS FQDN FQDN del CAS al que se asocia un sitio primario cuando se une a la jerarquía de Configuration Manager. Especifique el CAS durante la instalación.
CASRetryInterval No Minutos Si se produce un error en la conexión al CAS, el sitio primario espera este número de minutos y, a continuación, vuelve a intentar la conexión.
WaitForCASTimeout No 0 a 100 Valor de tiempo de espera máximo en minutos para que un sitio primario se conecte al CAS.
UseDistributionView No - 0: no habilitar
- 1:Habilitar
Especifique si se van a usar vistas distribuidas para optimizar la replicación de la base de datos.
JoinPrimarySiteName No FQDN del servidor de sitio FQDN del servidor de sitio principal que se va a expandir.

Administración de idiomas

Identification sección para idiomas

Incluya la siguiente clave en la Identification sección para administrar idiomas:

Nombre de clave Obligatorio Valores Detalles
Action Yes ManageLanguages Administra la compatibilidad del lenguaje de cliente móvil, cliente y servidor en un sitio.

Options sección para idiomas

Incluya las siguientes claves en la Options sección para administrar idiomas:

Nombre de clave Obligatorio Valores Detalles
AddServerLanguages No Vea la nota 1. Los lenguajes de servidor que estarán disponibles para la consola de Configuration Manager, los informes y otros objetos.
AddClientLanguages No Vea la nota 1. Idiomas que estarán disponibles para los equipos cliente.
DeleteServerLanguages No Vea la nota 1. Idiomas que se van a quitar. Ya no estarán disponibles para la consola de Configuration Manager, los informes y otros objetos.
DeleteClientLanguages No Vea la nota 1. Idiomas que se van a quitar y que ya no estarán disponibles para los equipos cliente. El inglés está disponible de forma predeterminada, no se puede quitar.
MobileDeviceLanguage Yes - 0: no se instala
- 1:Instalar
Especifique si están instalados los idiomas de cliente del dispositivo móvil.
PrerequisiteComp Yes - 0:Descargar
- 1: ya descargado
Especifique si los archivos de requisitos previos ya se han descargado. Por ejemplo, si usa un valor de , el programa de 0instalación descarga los archivos.
PrerequisitePath Yes Ruta de acceso del directorio local Ruta de acceso a los archivos de requisitos previos. En función del valor, el PrerequisiteComp programa de instalación usa esta ruta de acceso para almacenar los archivos descargados o para localizar los archivos descargados anteriormente.
ResetSecSiteLangs No - 0: no restablecer
- 1:Restablecer
Restablezca los paquetes de idioma instalados en un sitio secundario.

Nota 1: Valores de idioma admitidos

Use el código de tres letras para los idiomas de servidor o de cliente que Configuration Manager admite. Por ejemplo, para agregar compatibilidad con alemán en el cliente, especifique el siguiente par de clave y valor: AddClientLanguages=DEU

El inglés (ENG) está disponible de forma predeterminada. No es necesario agregarlo y no se puede quitar.

Recuperación de un sitio

Identification sección de site recovery

En función del tipo de sitio que esté recuperando, incluya las claves siguientes con los valores adecuados en la Identification sección:

Nombre de clave Obligatorio Valores Detalles
Action Yes RecoverPrimarySite
RecoverCCAR
- Recuperación de un sitio primario
- Recuperación de un CAS
CDLatest 3 1: el programa de instalación se ejecuta desde CD.Latest Al ejecutar el programa de instalación desde la carpeta CD.Latest, incluya esta clave y valor. Este valor indica al programa de instalación que está usando medios de CD.Latest.

Nota 3: CDLatest Obligatorio

La CDLatest clave solo es necesaria cuando se ejecuta el programa de instalación desde la CD.Latest carpeta para recuperar un sitio. Para obtener más información, vea Acerca del archivo de script de línea de comandos.

RecoveryOptions sección de site recovery

Incluya las claves siguientes en la RecoveryOptions sección para recuperar un sitio:

Nombre de clave Obligatorio Valores Detalles
ServerRecoveryOptions Yes - 1: servidor de sitio y SQL Server
- 2: solo servidor de sitio
- 4: solo SQL Server
Qué componentes se van a recuperar. Consulte la nota 4.
DatabaseRecoveryOptions Sí* - 10: restauración desde la copia de seguridad
- 20: se recuperó manualmente
- 40: crear una base de datos
- 80:Saltar
Especifique cómo el programa de instalación recupera la base de datos del sitio en SQL Server. * Solo se requiere cuando ServerRecoveryOptions es 1 o 4.
ReferenceSite Sí* FQDN Sitio primario de referencia que el CAS usa para recuperar datos globales. * Solo se requiere cuando DatabaseRecoveryOptions es 40. Consulte la nota 5.
SiteServerBackupLocation No Ruta de acceso del directorio Ruta de acceso al conjunto de copia de seguridad del servidor de sitio. Si no especifica un valor, el programa de instalación vuelve a instalar el sitio sin restaurarlo a partir de un conjunto de copia de seguridad.
BackupLocation Sí* Ruta de acceso del directorio Ruta de acceso al conjunto de copia de seguridad de base de datos de sitio. * Requerido cuando ServerRecoveryOptions es 1 o 4y DatabaseRecoveryOptions es 10.

Nota 4: ServerRecoveryOptions notas de valor

  • 1 o 2: para recuperar el sitio mediante una copia de seguridad del sitio, especifique un valor para SiteServerBackupLocation. Si no especifica un valor, el programa de instalación vuelve a instalar el sitio sin restaurarlo a partir de un conjunto de copia de seguridad.

  • 4: la BackupLocation clave es necesaria al configurar un valor de 10 para la DatabaseRecoveryOptions clave, que consiste en restaurar la base de datos del sitio a partir de la copia de seguridad.

Nota 5: ReferenceSite notas de valor

  • Si la copia de seguridad de la base de datos es anterior al período de retención de seguimiento de cambios o al recuperar el sitio sin una copia de seguridad, especifique el sitio primario de referencia que el CAS usa para recuperar datos globales.

  • Cuando no se especifica un sitio de referencia y la copia de seguridad es anterior al período de retención de seguimiento de cambios, todos los sitios primarios se reinicializan con los datos restaurados del CAS.

  • Cuando no se especifica un sitio de referencia y la copia de seguridad está dentro del período de retención de seguimiento de cambios, solo los cambios que se realizan después de la copia de seguridad se replican desde sitios primarios. Cuando hay cambios en conflicto de diferentes sitios primarios, el CAS usa el primero que recibe.

Options sección de site recovery

Muchas de las claves de la Options sección también son necesarias para site recovery. Para obtener más información, consulte Options la sección para la instalación del sitio. En la tabla siguiente se resumen las claves de la Options sección de site recovery:

Nombre de clave Obligatorio Comentario
ProductID
SiteCode Use el mismo código de sitio que usó antes del error.
SiteName No
SMSInstallDir
SDKServer Use el mismo servidor que hospedaba este rol antes del error.
PrerequisiteComp
PrerequisitePath
AdminConsole Sí* * Solo se requiere cuando ServerRecoveryOptions es 1 o 2.
JoinCEIP Yes

SQLConfigOptions sección de site recovery

Muchas de las claves de la SQLConfigOptions sección también son necesarias para site recovery. Para obtener más información, consulte SQLConfigOptions la sección para la instalación del sitio. En la tabla siguiente se resumen las claves de la SQLConfigOptions sección de site recovery:

Nombre de clave Obligatorio Comentario
SQLServerName Yes Use el mismo servidor que hospedaba la base de datos del sitio antes del error.
DatabaseName Yes Use el mismo nombre de base de datos que se usó antes del error.
SQLSSBPort Yes Use el mismo puerto que se usó antes del error.
SQLDataFilePath No
SQLLogFilePath No

CloudConnectorOptions sección de site recovery

Muchas de las claves de la CloudConnectorOptions sección también son necesarias para site recovery. Para obtener más información, consulte CloudConnectorOptions la sección para la instalación del sitio. En la tabla siguiente se resumen las claves de la CloudConnectorOptions sección de site recovery:

Nombre de clave Obligatorio Comentario
CloudConnector
CloudConnectorServer Sí* * Solo se requiere cuando CloudConnector es igual a 1.
UseProxy Sí* * Solo se requiere cuando CloudConnector es igual a 1.
ProxyName Sí* * Solo se requiere cuando UseProxy es igual a 1.
ProxyPort Sí* * Solo se requiere cuando UseProxy es igual a 1.

HierarchyExpansionOption sección de site recovery

Muchas de las claves de la HierarchyExpansionOption sección también son necesarias para site recovery. Para obtener más información, consulte HierarchyExpansionOption la sección para la instalación del sitio. En la tabla siguiente se resumen las claves de la HierarchyExpansionOption sección de site recovery:

Nombre de clave Obligatorio Comentario
CCARSiteServer Sí* * Solo es necesario si el sitio primario se ha adjuntado a un CAS antes del error.
CASRetryInterval No
WaitForCASTimeout No

Ejemplos

Script de ejemplo para instalar un sitio 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