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:
- Información general de la línea de comandos
- Opciones de la línea de comandos del programa de instalación
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 Action
Identification
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 |
Sí 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 0 instalació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 0 instalació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 |
Sí 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 4 y DatabaseRecoveryOptions es 10 . |
Nota 4: ServerRecoveryOptions
notas de valor
1
o2
: para recuperar el sitio mediante una copia de seguridad del sitio, especifique un valor paraSiteServerBackupLocation
. 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
: laBackupLocation
clave es necesaria al configurar un valor de10
para laDatabaseRecoveryOptions
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 |
Sí | |
SiteCode |
Sí | Use el mismo código de sitio que usó antes del error. |
SiteName |
No | |
SMSInstallDir |
Sí | |
SDKServer |
Sí | Use el mismo servidor que hospedaba este rol antes del error. |
PrerequisiteComp |
Sí | |
PrerequisitePath |
Sí | |
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 |
Sí | |
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