Acerca de los parámetros y propiedades de instalación de cliente en Administrador de configuración

Se aplica a: Administrador de configuración (rama actual)

Use el comando CCMSetup.exe para instalar el cliente de Administrador de configuración. Si proporciona parámetros de instalación de cliente en la línea de comandos, se modifica el comportamiento de instalación. Si proporciona propiedades de instalación de cliente en la línea de comandos, estas modifican la configuración inicial del agente de cliente instalado.

Acerca de CCMSetup.exe

El comando CCMSetup.exe descarga los archivos necesarios para instalar el cliente desde un punto de administración o una ubicación de origen. Entre estos archivos se incluyen:

• El paquete de Windows Installer client.msi que instala el software cliente

• Requisitos previos del cliente

• Novedades y correcciones para el cliente de Administrador de configuración

CCMSetup.exe proporciona parámetros de línea de comandos para personalizar la instalación. Los parámetros tienen el prefijo de una barra diagonal (/) y generalmente están en minúsculas. Cuando sea necesario, especifique el valor de un parámetro mediante dos puntos (::) inmediatamente seguidos del valor. Para obtener más información, consulte CCMSetup.exe parámetros de línea de comandos.

También puede proporcionar propiedades en la línea de comandos CCMSetup.exe para modificar el comportamiento de client.msi. Las propiedades por convención están en mayúsculas. Especifica un valor para una propiedad usando un signo igual (=) inmediatamente seguido del valor. Para obtener más información, consulta Client.msi propiedades.

CCMSetup.exe y los archivos auxiliares están en el servidor del sitio, en la carpeta Cliente de la carpeta de instalación de Administrador de configuración. Administrador de configuración comparte esta carpeta con la red dentro del recurso compartido del sitio. Por ejemplo, \\SiteServer\SMS_ABC\Client.

En el símbolo del sistema, el comando CCMSetup.exe utiliza el siguiente formato:

CCMSetup.exe [<Ccmsetup parameters>] [<client.msi setup properties>]

Por ejemplo:

CCMSetup.exe /mp:SMSMP01 /logon SMSSITECODE=S01 FSP=SMSFSP01

Este ejemplo hace lo siguiente:

• Especifica el punto de administración denominado SMSMP01 para solicitar una lista de puntos de distribución a fin de descargar los archivos de instalación del cliente.

• Especifica que la instalación debe detenerse si ya existe una versión del cliente en el equipo.

• Indica a client.msi que asigne el cliente al código de sitio S01.

• Indica a client.msi que usen el punto de estado de reserva denominado SMSFP01.

Si extiende el esquema de Active Directory para Administrador de configuración, el sitio publica muchas propiedades de instalación de cliente en Servicios de dominio de Active Directory. El cliente de Administrador de configuración lee automáticamente estas propiedades. Para obtener más información, consulte Acerca de las propiedades de instalación de cliente publicadas en Servicios de dominio de Active Directory

CCMSetup.exe parámetros de línea de comandos

/?

Muestra los parámetros de línea de comandos disponibles para ccmsetup.exe.

Ejemplo: ccmsetup.exe /?

/AllowMetered

Use este parámetro para controlar el comportamiento del cliente en una red de uso medido. Este parámetro no toma valores. Cuando se permite la comunicación con el cliente en una red de uso medido para ccmsetup, se descarga el contenido, se registra en el sitio y se descarga la directiva inicial. Cualquier comunicación posterior con el cliente sigue la configuración de la configuración de cliente de esa directiva. Para obtener más información, consulte Acerca de la configuración de los clientes.

Si vuelve a instalar el cliente en un dispositivo existente, usa la siguiente prioridad para determinar su configuración:

1. Directiva de cliente local existente
2. La última línea de comandos almacenada en el Registro de Windows
3. Parámetros en la línea de comandos ccmsetup

/AlwaysExcludeUpgrade

Este parámetro especifica si un cliente actualizará automáticamente al habilitar la actualización automática de cliente.

Valores admitidos:

• TRUE: el cliente no se actualizará automáticamente
• FALSE: el cliente se actualiza automáticamente (valor predeterminado)

Por ejemplo:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

Para obtener más información, consulte Cliente de interoperabilidad extendida.

/BITSPriority

Cuando el dispositivo descargue los archivos de instalación del cliente a través de una conexión HTTP, use este parámetro para especificar la prioridad de descarga. Especifique uno de los siguientes valores posibles:

• FOREGROUND

• HIGH

• NORMAL (predeterminado)

• LOW

Ejemplo: ccmsetup.exe /BITSPriority:HIGH

/config

Este parámetro especifica un archivo de texto que enumera las propiedades de instalación del cliente.

• Si CCMSetup se ejecuta como un servicio, coloque este archivo en la carpeta del sistema CCMSetup: %Windir%\Ccmsetup.

• Si especifica el /noservice parámetro, coloque este archivo en la misma carpeta que CCMSetup.exe.

Ejemplo: CCMSetup.exe /config:"configuration file name.txt"

Para proporcionar el formato de archivo correcto, utilice el archivo mobileclienttemplate.tcf de la \bin\<platform> carpeta del directorio de instalación de Administrador de configuración en el servidor del sitio. Este archivo tiene comentarios sobre las secciones y cómo usarlas. Especifique las propiedades de instalación de cliente en la [Client Install] sección, después del siguiente texto: Install=INSTALL=ALL.

Ejemplo [Client Install] de entrada de sección: Install=INSTALL=ALL SMSSITECODE=ABC SMSCACHESIZE=100

/downloadtimeout

Si CCMSetup no puede descargar los archivos de instalación del cliente, este parámetro especifica el tiempo de espera máximo en minutos. Después de este tiempo de espera, CCMSetup deja de intentar descargar los archivos de instalación. El valor predeterminado es 1440 minutos (un día).

Usa el /retry parámetro para especificar el intervalo entre los reintentos.

Ejemplo: ccmsetup.exe /downloadtimeout:100

/ExcludeFeatures

Este parámetro especifica que CCMSetup.exe no instala la característica especificada.

Ejemplo: CCMSetup.exe /ExcludeFeatures:ClientUI no instala el Centro de software en el cliente.

/forceinstall

Especifique que CCMSetup.exe desinstala cualquier cliente existente e instala un nuevo cliente.

/forcereboot

Utilice este parámetro para forzar el reinicio del equipo si es necesario para completar la instalación. Si no especifica este parámetro, CCMSetup se cerrará cuando sea necesario reiniciar. A continuación, continúa después del siguiente reinicio manual.

Ejemplo: CCMSetup.exe /forcereboot

/logon

Si ya hay instalada alguna versión del cliente, este parámetro especifica que la instalación del cliente debe detenerse.

Ejemplo: ccmsetup.exe /logon

/mp

Especifica un punto de administración que los clientes pueden usar para buscar el punto de distribución más cercano para los archivos de instalación del cliente. Si no hay puntos de distribución o los equipos no pueden descargar los archivos de los puntos de distribución después de cuatro horas, descargan los archivos desde el punto de administración especificado.

Para obtener más información sobre cómo descarga contenido ccmsetup, consulte Grupos de límites: instalación del cliente. En ese artículo también se incluyen detalles sobre el comportamiento de ccmsetup si usa ambos /mp parámetros /source .

Los equipos descargan los archivos a través de una conexión HTTP o HTTPS, según la configuración de la función del sistema del sitio para las conexiones de cliente. La descarga también puede usar la limitación de BITS si la configura. Si configura todos los puntos de distribución y administración solo para las conexiones de cliente HTTPS, compruebe que el equipo cliente tenga un certificado de cliente válido.

Puede usar el /mp parámetro de línea de comandos para especificar más de un punto de administración. Si el equipo no puede conectarse a la primera, intenta la siguiente de la lista especificada. Cuando especifique varios puntos de administración, separe los valores con punto y coma.

Si el cliente se conecta a un punto de administración mediante HTTPS, especifique el FQDN, no el nombre del equipo. El valor debe coincidir con el Asunto o el Nombre alternativo del sujeto del certificado PKI del punto de administración. Aunque Administrador de configuración admite el uso de un nombre de equipo en el certificado para las conexiones en la intranet, se recomienda usar un FQDN.

Ejemplo con el nombre del equipo: ccmsetup.exe /mp:SMSMP01

Ejemplo con el FQDN: ccmsetup.exe /mp:smsmp01.contoso.com

Este parámetro también puede especificar la dirección URL de una puerta de enlace de administración en la nube (CMG). Use esta dirección URL para instalar el cliente en un dispositivo basado en Internet. Para obtener el valor de este parámetro, siga estos pasos:

• Crear un CMG. Para obtener más información, consulte Configurar una instancia de CMG.

• En un cliente activo, abra un símbolo del sistema de Windows PowerShell como administrador.

• Ejecute el siguiente comando:

  (Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MP
  

• Anexe el https:// prefijo que se usará con el /mp parámetro.

Ejemplo de cuándo se usa la URL de la puerta de enlace de administración en la nube: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

/NoCRLCheck

Especifica que un cliente no debe comprobar la lista de revocación de certificados (CRL) cuando se comunica a través de HTTPS con un certificado PKI. Si no especifica este parámetro, el cliente comprueba la CRL antes de establecer una conexión HTTPS. Para obtener más información sobre la comprobación de CRL del cliente, consulte Planificación de la revocación de certificados PKI.

Ejemplo: CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

Este parámetro impide que CCMSetup se ejecute como un servicio, lo que hace de forma predeterminada. Cuando CCMSetup se ejecuta como un servicio, se ejecuta en el contexto de la cuenta de sistema local del equipo. Es posible que esta cuenta no tenga derechos suficientes para acceder a los recursos de red necesarios para la instalación. Con /noservice, CCMSetup.exe se ejecuta en el contexto de la cuenta de usuario que usa para iniciar la instalación.

Ejemplo: ccmsetup.exe /noservice

/regtoken

Use este parámetro para proporcionar un token de registro masivo. Un dispositivo basado en Internet usa este token en el proceso de registro a través de una puerta de enlace de administración en la nube (CMG). Para obtener más información, consulte Autenticación basada en tokens para CMG.

Cuando use este parámetro, incluya también los parámetros y propiedades siguientes:

• /mp
• CCMHOSTNAME
• SMSSITECODE
• SMSMP

La siguiente línea de comandos de ejemplo incluye las otras propiedades y parámetros de configuración necesarios:

ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72186325152220500 CCMHOSTNAME=CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72186325152220500 SMSSITECODE=ABC SMSMP=https://mp1.contoso.com /regtoken:eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6Ik9Tbzh2Tmd5VldRUjlDYVh5T2lacHFlMDlXNCJ9.eyJTQ0NNVG9rZW5DYXRlZ29yeSI6IlN7Q01QcmVBdXRoVG9rZW4iLCJBdXRob3JpdHkiOiJTQ0NNIiwiTGljZW5zZSI6IlNDQ00iLCJUeXBlIjoiQnVsa1JlZ2lzdHJhdGlvbiIsIlRlbmFudElkIjoiQ0RDQzVFOTEtMEFERi00QTI0LTgyRDAtMTk2NjY3RjFDMDgxIiwiVW5pcXVlSWQiOiJkYjU5MWUzMy1wNmZkLTRjNWItODJmMy1iZjY3M2U1YmQwYTIiLCJpc3MiOiJ1cm46c2NjbTpvYXV0aDI6Y2RjYzVlOTEtMGFkZi00YTI0LTgyZDAtMTk2NjY3ZjFjMDgxIiwiYXVkIjoidXJuOnNjY206c2VydmljZSIsImV4cCI6MTU4MDQxNbUwNSwibmJmIjoxNTgwMTU2MzA1fQ.ZUJkxCX6lxHUZhMH_WhYXFm_tbXenEdpgnbIqI1h8hYIJw7xDk3wv625SCfNfsqxhAwRwJByfkXdVGgIpAcFshzArXUVPPvmiUGaxlbB83etUTQjrLIk-gvQQZiE5NSgJ63LCp5KtqFCZe8vlZxnOloErFIrebjFikxqAgwOO4i5ukJdl3KQ07YPRhwpuXmwxRf1vsiawXBvTMhy40SOeZ3mAyCRypQpQNa7NM3adCBwUtYKwHqiX3r1jQU0y57LvU_brBfLUL6JUpk3ri-LSpwPFarRXzZPJUu4-mQFIgrMmKCYbFk3AaEvvrJienfWSvFYLpIYA7lg-6EVYRcCAA

/retry

Si CCMSetup.exe no puede descargar los archivos de instalación, use este parámetro para especificar el intervalo de reintento en minutos. CCMSetup continúa reintentando hasta que alcanza el límite especificado en el /downloadtimeout parámetro.

Ejemplo: ccmsetup.exe /retry:20

/service

Especifica que CCMSetup debe ejecutarse como un servicio que utiliza la cuenta Sistema local.

Ejemplo: ccmsetup.exe /service

/skipprereq

Este parámetro especifica que CCMSetup.exe no instala el requisito previo especificado. Puede especificar más de un valor. Use el carácter de punto y coma (;) para separar cada valor.

Ejemplos:

• CCMSetup.exe /skipprereq:filename.exe

• CCMSetup.exe /skipprereq:filename1.exe;filename2.exe

Para obtener más información sobre los requisitos previos del cliente, consulte Requisitos previos del cliente de Windows.

/source

Especifica la ubicación de descarga del archivo. Use una ruta de acceso local o UNC. El dispositivo descarga los archivos mediante el protocolo de bloque de mensajes del servidor (SMB). Para usar /source, la cuenta de usuario de Windows para la instalación del cliente necesita permisos de lectura en la ubicación.

Para obtener más información sobre cómo descarga contenido ccmsetup, consulte Grupos de límites: instalación del cliente. En ese artículo también se incluyen detalles sobre el comportamiento de ccmsetup si usa ambos /mp parámetros /source .

Ejemplo: ccmsetup.exe /source:"\\server\share"

/uninstall

Usa este parámetro para desinstalar el cliente de Administrador de configuración. Para obtener más información, consulte Desinstalación del cliente.

Ejemplo: ccmsetup.exe /uninstall

/UsePKICert

Especifique este parámetro para que el cliente use un certificado de autenticación de cliente PKI. Si no incluye este parámetro, o si el cliente no encuentra un certificado válido, se filtran todos los puntos de administración HTTPS, incluidas las puertas de enlace de administración en la nube (CMG). El cliente utiliza una conexión HTTP con un certificado autofirmado.

Ejemplo: CCMSetup.exe /UsePKICert

Si un dispositivo usa Microsoft Entra ID para la autenticación de cliente y también tiene un certificado de autenticación de cliente basado en PKI, si usa incluir este parámetro, el cliente no podrá obtener información de incorporación de Microsoft Entra de una puerta de enlace de administración en la nube (CMG). Para un cliente que utiliza la autenticación de Microsoft Entra, no especifique este parámetro, pero incluya las propiedades AADRESOURCEURI y AADCLIENTAPPID.

/IgnoreSkipUpgrade

Especifique este parámetro para actualizar manualmente un cliente excluido. Para obtener más información, consulte Cómo excluir clientes de la actualización.

CCMSetup.exe códigos de retorno

El comando CCMSetup.exe proporciona los siguientes códigos de retorno. Para solucionarlos, revisa %WinDir%\ccmsetup\Logs\ccmsetup.log el cliente para obtener contexto y detalles adicionales sobre los códigos de retorno.

Ccmsetup.msi propiedades

Las propiedades siguientes pueden modificar el comportamiento de instalación de ccmsetup.msi.

CCMSETUPCMD

Use este ccmsetup. Propiedad MSI para pasar parámetros de línea de comandos y propiedades adicionales a ccmsetup. exe. Incluir otros parámetros y propiedades entre comillas ("). Use esta propiedad al arrancar el cliente de Administrador de configuración con el método de instalación MDM de Intune.

Ejemplo: ccmsetup.msi CCMSETUPCMD="/mp:https://mp.contoso.com CCMHOSTNAME=mp.contoso.com"

Client.msi propiedades

Las siguientes propiedades pueden modificar el comportamiento de instalación de client.msi, que ccmsetup.exe instala.

AADCLIENTAPPID

Especifica el identificador de la aplicación cliente de Microsoft Entra. La aplicación cliente se crea o se importa al configurar los servicios de Azure para Cloud Management. Un administrador de Azure puede obtener el valor de esta propiedad en el portal de Azure Portal. Para obtener más información, consulte Obtener id. de aplicación. Para la AADCLIENTAPPID propiedad, este identificador de aplicación es para el tipo de aplicación nativa .

Ejemplo: ccmsetup.exe AADCLIENTAPPID=aa28e7f1-b88a-43cd-a2e3-f88b257c863b

AADRESOURCEURI

Especifica el identificador de la aplicación del servidor Microsoft Entra. Cree o importe la aplicación de servidor al configurar los servicios de Azure para la administración de nubes. Al crear la aplicación de servidor, en la ventana Crear aplicación de servidor, esta propiedad es el URI del id. de la aplicación.

Un administrador de Azure puede obtener el valor de esta propiedad en el portal de Azure Portal. En Microsoft Entra ID, busque la aplicación del servidor en Registros de aplicaciones. Busque el tipo de aplicación Aplicación web o API. Abra la aplicación, seleccione Configuración y, a continuación, seleccione Propiedades. Use el valor URI de id. de aplicación para esta AADRESOURCEURI propiedad de instalación de cliente.

Ejemplo: ccmsetup.exe AADRESOURCEURI=https://contososerver

AADTENANTID

Especifica el identificador de inquilino de Microsoft Entra. Administrador de configuración se vincula a este inquilino al configurar los servicios de Azure para Cloud Management. Para obtener el valor de esta propiedad, siga estos pasos:

• En un dispositivo que ejecute Windows 10 o posterior y que esté unido al mismo inquilino de Microsoft Entra, abra un símbolo del sistema.

• Ejecute el siguiente comando: dsregcmd.exe /status

• En la sección Estado del dispositivo, busque el valor TenantId . Por ejemplo: TenantId : aaaabbbb-0000-cccc-1111-dddd2222eeee

  Nota:

  Un administrador de Azure también puede obtener este valor en el Azure Portal. Para obtener más información, consulte Obtener id. de inquilino.

Ejemplo: ccmsetup.exe AADTENANTID=aaaabbbb-0000-cccc-1111-dddd2222eeee

CCMADMINS

Especifica que una o varias cuentas de usuario o grupos de Windows tendrán acceso a la configuración y las directivas de cliente. Esta propiedad es útil cuando no tiene credenciales administrativas locales en el equipo cliente. Especifique una lista de cuentas separadas por punto y coma (;).

Ejemplo: CCMSetup.exe CCMADMINS="domain\account1;domain\group1"

CCMALLOWSILENTREBOOT

Si es necesario, deje que el equipo se reinicie silenciosamente después de la instalación del cliente.

Ejemplo: CCMSetup.exe CCMALLOWSILENTREBOOT

CCMALWAYSINF

Para especificar que el cliente siempre está basado en Internet y nunca se conecta a la intranet, establezca este valor de propiedad en 1. El tipo de conexión del cliente muestra Siempre Internet.

Use esta propiedad con CCMHOSTNAME para especificar el nombre completo del punto de administración basado en Internet. Úselo también con el parámetro CCMSetup UsePKICert y la propiedad SMSSITECODE .

Para obtener más información sobre la administración de clientes basada en Internet, vea Consideraciones para las comunicaciones de cliente desde Internet o un bosque que no es de confianza.

Ejemplo: CCMSetup.exe /UsePKICert CCMALWAYSINF=1 CCMHOSTNAME=SERVER3.CONTOSO.COM SMSSITECODE=ABC

CCMCERTISSUERS

Utilice esta propiedad para especificar la lista de emisores de certificados. En esta lista se incluye información sobre los certificados de las entidades emisoras de certificados raíz (CA) de confianza en las que confía el sitio de Administrador de configuración.

Este valor es una coincidencia que distingue mayúsculas de minúsculas para los atributos del firmante que se encuentran en el certificado de CA raíz. Separe los atributos con una coma (,) o un punto y coma (;). Especifique más de un certificado de CA raíz mediante una barra separadora (|).

Ejemplo: CCMCERTISSUERS="CN=Contoso Root CA; OU=Servers; O=Contoso, Ltd; C=US | CN=Litware Corporate Root CA; O=Litware, Inc."

Para obtener más información sobre la lista de emisores de certificados y cómo la usan los clientes durante el proceso de selección de certificados, consulte Planificación de la selección de certificados de cliente de PKI.

CCMCERTNAMECHECK

A partir de la versión 2207, esta propiedad se puede usar para omitir la comprobación del nombre del firmante para el certificado. CCMCERTNAMECHECK=0 Omite la comprobación del nombre del firmante del certificado.

CCMCERTSEL

Si el cliente tiene más de un certificado para la comunicación HTTPS, esta propiedad especifica los criterios para seleccionar un certificado de autenticación de cliente válido.

Use las siguientes palabras clave para buscar en el certificado: Nombre del firmante o nombre alternativo del sujeto:

• Subject: busca una coincidencia exacta
• SubjectStr: Buscar una coincidencia parcial

Ejemplos:

• CCMCERTSEL="Subject:computer1.contoso.com": busque un certificado con una coincidencia exacta con el nombre computer1.contoso.com del equipo en el nombre del firmante o en el nombre alternativo del sujeto.

• CCMCERTSEL="SubjectStr:contoso.com": busque un certificado que contenga contoso.com el nombre del Firmante o el Nombre Alternativo del Sujeto.

Use la SubjectAttr palabra clave para buscar los atributos de identificador de objeto (OID) o de nombre completo en el nombre del firmante o en el nombre alternativo del firmante.

Ejemplos:

• CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": busca el atributo de unidad organizativa expresado como un identificador de objeto y con nombre Computers.

• CCMCERTSEL="SubjectAttr:OU = Computers": busque el atributo de unidad organizativa expresado como un nombre completo y con nombre Computers.

Para obtener la lista completa de atributos que puede usar para la selección de certificados, consulte Valores de atributo admitidos para los criterios de selección de certificados PKI.

Si más de un certificado coincide con la búsqueda y establece CCMFIRSTCERT el valor 1, el instalador del cliente selecciona el certificado con el período de validez más largo.

CCMCERTSTORE

Si el instalador del cliente no encuentra un certificado válido en el almacén predeterminado de certificados personales para el equipo, use esta propiedad para especificar un nombre de almacén de certificados alternativo.

Ejemplo: CCMSetup.exe /UsePKICert CCMCERTSTORE="ConfigMgr"

CCMDEBUGLOGGING

Esta propiedad habilita el registro de depuración cuando el cliente se instala. Esta propiedad hace que el cliente registre información de bajo nivel para la solución de problemas. Evite usar esta propiedad en los sitios de producción. Se puede producir un registro excesivo, lo que puede dificultar la búsqueda de información relevante en los archivos de registro. Habilite CCMENABLELOGGINGtambién .

Valores admitidos:

• 0: desactivar el registro de depuración (predeterminado)
• 1: Activar el registro de depuración

Ejemplo: CCMSetup.exe CCMDEBUGLOGGING=1

Para obtener más información, consulte Acerca de los archivos de registro.

CCMENABLELOGGING

Administrador de configuración habilita el registro de forma predeterminada.

Valores admitidos:

• TRUE: Activar el registro (predeterminado)
• FALSE: Desactivar el registro

Ejemplo: CCMSetup.exe CCMENABLELOGGING=TRUE

Para obtener más información, consulte Acerca de los archivos de registro.

CCMEVALINTERVAL

La frecuencia en minutos con la que se ejecuta la herramienta de evaluación del estado del cliente (ccmeval.exe). Especifique un valor entero de 1 to .1440 De forma predeterminada, ccmeval se ejecuta una vez al día (1440 minutos).

Ejemplo: CCMSetup.exe CCMEVALINTERVAL=1440

Para obtener más información sobre la evaluación del estado del cliente, consulte Supervisión de clientes.

CCMEVALHOUR

La hora del día en que se ejecuta la herramienta de evaluación del estado del cliente (ccmeval.exe). Especifique un valor entero desde 0 (medianoche) hasta ( 23 11:00 p. m.). De forma predeterminada, ccmeval se ejecuta a medianoche.

Para obtener más información sobre la evaluación del estado del cliente, consulte Supervisión de clientes.

CCMFIRSTCERT

Si establece esta propiedad en 1, el cliente selecciona el certificado PKI con el período de validez más largo.

Ejemplo: CCMSetup.exe /UsePKICert CCMFIRSTCERT=1

CCMHOSTNAME

Si el cliente se administra a través de Internet, esta propiedad especifica el nombre completo del punto de administración basado en Internet.

No especifique esta opción con la propiedad de instalación de SMSSITECODE=AUTO. Asigne directamente clientes basados en Internet a un sitio basado en Internet.

Ejemplo: CCMSetup.exe /UsePKICert CCMHOSTNAME="SMSMP01.corp.contoso.com"

Esta propiedad puede especificar la dirección de una puerta de enlace de administración en la nube (CMG). Para obtener el valor de esta propiedad, siga estos pasos:

• Crear un CMG. Para obtener más información, consulte Configurar una instancia de CMG.

• En un cliente activo, abra un símbolo del sistema de Windows PowerShell como administrador.

• Ejecute el siguiente comando:

  (Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MP
  

• Use el valor devuelto tal cual con la CCMHOSTNAME propiedad.

Por ejemplo: ccmsetup.exe CCMHOSTNAME=CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

CCMHTTPPORT

Especifica el puerto que usará el cliente cuando se comunique por HTTP con los servidores del sistema de sitio. De forma predeterminada, este valor es 80.

Ejemplo: CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORT

Especifica el puerto que debe usar el cliente cuando se comunique a través de HTTPS con los servidores del sistema del sitio. De forma predeterminada, este valor es 443.

Ejemplo: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

Use esta propiedad para establecer la carpeta para instalar los archivos de cliente de Administrador de configuración. De forma predeterminada, usa %WinDir%\CCM.

Ejemplo: CCMSetup.exe CCMINSTALLDIR="C:\ConfigMgr"

CCMLOGLEVEL

Use esta propiedad para especificar el nivel de detalle que se escribirá en los archivos de registro de Administrador de configuración.

Valores admitidos:

• 0: Detallado
• 1: Valor predeterminado
• 2: Advertencias y errores
• 3: Solo errores

Ejemplo: CCMSetup.exe CCMLOGLEVEL=0

Para obtener más información, consulte Acerca de los archivos de registro.

CCMLOGMAXHISTORY

Cuando un archivo de registro de Administrador de configuración alcanza el tamaño máximo, el cliente lo renombra como copia de seguridad y crea un nuevo archivo de registro. Esta propiedad especifica cuántas versiones anteriores del archivo de registro se van a conservar. El valor predeterminado es 1. Si establece el valor en 0, el cliente no guarda ningún historial de archivos de registro.

Ejemplo: CCMSetup.exe CCMLOGMAXHISTORY=5

Para obtener más información, consulte Acerca de los archivos de registro.

CCMLOGMAXSIZE

Esta propiedad especifica el tamaño máximo del archivo de registro en bytes. Cuando un registro crece hasta el tamaño especificado, el cliente lo renombra como archivo de historial y crea uno nuevo. El tamaño predeterminado es 250 000 bytes y el tamaño mínimo es 10 000 bytes.

Ejemplo: CCMSetup.exe CCMLOGMAXSIZE=300000 (300 000 bytes)

DISABLESITEOPT

Establezca esta propiedad en TRUE impedir que los administradores cambien el sitio asignado en el panel de control de Administrador de configuración.

Ejemplo: CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

Si se establece en TRUE, esta propiedad impide que los usuarios administrativos cambien la configuración de la carpeta de caché de cliente en el panel de control de Administrador de configuración.

Ejemplo: CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIX

Especifique un dominio DNS para que los clientes encuentren los puntos de administración que publica en DNS. Cuando el cliente localiza un punto de administración, informa al cliente sobre otros puntos de administración en la jerarquía. Este comportamiento significa que el punto de administración que el cliente encuentra de DNS puede ser cualquiera en la jerarquía.

Para obtener más información sobre la publicación DNS como método de ubicación de servicio para clientes de Administrador de configuración, consulte Ubicación del servicio y cómo los clientes determinan su punto de administración asignado.

Ejemplo: CCMSetup.exe SMSSITECODE=ABC DNSSUFFIX=contoso.com

FSP

Especifique el punto de estado de reserva que recibe y procesa los mensajes de estado enviados por los clientes de Administrador de configuración.

Para obtener más información, consulte Determinar si necesita un punto de estado de reserva.

Ejemplo: CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

Si establece esta propiedad en TRUE, el instalador del cliente no comprueba la versión mínima necesaria de Microsoft Application Virtualization (App-V).

Ejemplo: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

MANAGEDINSTALLER

Si establece esta propiedad en 1 ccmsetup.exe y client.msi se establecen como instaladores administrados. Para obtener más información, consulte Permitir automáticamente aplicaciones implementadas por un instalador administrado con Control de aplicaciones de Windows Defender.

Ejemplo: CCMSetup.exe MANAGEDINSTALLER=1

NOTIFYONLY

Cuando habilita esta propiedad, el cliente notifica el estado, pero no corrige los problemas que encuentra.

Ejemplo: CCMSetup.exe NOTIFYONLY=TRUE

Para obtener más información, consulte Cómo configurar el estado de cliente.

PROVISIONTS

Use esta propiedad para iniciar una secuencia de tareas en un cliente después de que se registre correctamente en el sitio.

Por ejemplo, aprovisionas un nuevo dispositivo Windows con Windows Autopilot, lo inscribes automáticamente en Microsoft Intune y, a continuación, instalas el cliente de Administrador de configuración para la administración conjunta. Si especifica esta nueva opción, el cliente recién aprovisionado ejecutará una secuencia de tareas. Este proceso le ofrece flexibilidad adicional para instalar aplicaciones y actualizaciones de software, o configurar las opciones.

Utilice el siguiente proceso:

1. Cree una secuencia de tareas de implementación que no sea del sistema operativo para instalar aplicaciones, instalar actualizaciones de software y configurar las opciones.

2. Implemente esta secuencia de tareas en la nueva colección integrada, Todos los dispositivos de aprovisionamiento. Anote el ID de implementación de secuencia de tareas, por ejemplo PRI20001.

   Sugerencia

   El propósito de la implementación puede ser Disponible o Obligatorio. Puesto que especifica el id. de implementación como el valor de propiedad, el propósito no importa.

3. Instale el cliente de Administrador de configuración en un dispositivo mediante ccmsetup.msie incluya la siguiente propiedad: PROVISIONTS=PRI20001. Establezca el valor de esta propiedad como el identificador de implementación de secuencia de tareas.

   • Si va a instalar el cliente desde Intune durante la inscripción de administración conjunta, consulte Cómo preparar dispositivos basados en Internet para la administración conjunta.

     Nota:

     Este método puede tener requisitos previos adicionales. Por ejemplo, inscribir el sitio en Microsoft Entra ID o crear una puerta de enlace de administración en la nube habilitada para contenido.

     Independientemente del método, use esta propiedad solo con ccmsetup.msi.

Una vez que el cliente se instala y se registra correctamente en el sitio, inicia la secuencia de tareas a la que se hace referencia. Si se produce un error en el registro del cliente, la secuencia de tareas no se iniciará.

RESETKEYINFORMATION

Si un cliente tiene una clave raíz de confianza de Administrador de configuración incorrecta, no podrá ponerse en contacto con un punto de administración de confianza para recibir la nueva clave raíz de confianza. Use esta propiedad para quitar la antigua clave raíz de confianza. Esta situación puede producirse al mover un cliente de una jerarquía de sitios a otra. Esta propiedad se aplica a los clientes que usan la comunicación de cliente HTTP y HTTPS. Para obtener más información, consulte Planeación de la clave raíz de confianza.

Ejemplo: CCMSetup.exe RESETKEYINFORMATION=TRUE

SITEREASSIGN

Habilita la reasignación automática de sitios para las actualizaciones de clientes cuando se usa con SMSSITECODE=AUTO.

Ejemplo: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE

SMSCACHEDIR

Especifica la ubicación de la carpeta de caché de cliente en el equipo cliente. De forma predeterminada, la ubicación de la memoria caché es %WinDir%\ccmcache.

Ejemplo: CCMSetup.exe SMSCACHEDIR="C:\Temp"

Use esta propiedad con la SMSCACHEFLAGS propiedad para controlar la ubicación de la carpeta caché de cliente. Por ejemplo, para instalar la carpeta de caché de cliente en la unidad de disco cliente más grande disponible: CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE

SMSCACHEFLAGS

Use esta propiedad para especificar otros detalles de instalación para la carpeta de caché de cliente. Puede usar SMSCACHEFLAGS las propiedades de forma individual o en combinación separadas por punto y coma (;).

Si no incluye esta propiedad:

• El cliente instala la carpeta de caché de acuerdo con la SMSCACHEDIR propiedad
• La carpeta no está comprimida
• El cliente utiliza la SMSCACHESIZE propiedad como el límite de tamaño en MB de la memoria caché

Al actualizar un cliente existente, el instalador del cliente omite esta propiedad.

Valores de la SMSCACHEFLAGS propiedad

• PERCENTDISKSPACE: establece el tamaño de caché como un porcentaje del espacio total en disco. Si especifica esta propiedad, también establézcala SMSCACHESIZE en un valor de porcentaje.

• PERCENTFREEDISKSPACE: establece el tamaño de caché como un porcentaje del espacio libre en disco. Si especifica esta propiedad, también establézcala SMSCACHESIZE como un valor de porcentaje. Por ejemplo, el disco tiene 10 MB libres y especifique SMSCACHESIZE=50. El instalador del cliente establece el tamaño de caché en 5 MB. No puede usar esta propiedad con la PERCENTDISKSPACE propiedad.

• MAXDRIVE: instalar la memoria caché en el disco más grande disponible. Si especifica una ruta de acceso con la SMSCACHEDIR propiedad, el instalador del cliente omite este valor.

• MAXDRIVESPACE: instale la memoria caché en la unidad de disco con más espacio libre. Si especifica una ruta de acceso con la SMSCACHEDIR propiedad, el instalador del cliente omite este valor.

• NTFSONLY: solo instale la memoria caché en una unidad de disco con formato NTFS. Si especifica una ruta de acceso con la SMSCACHEDIR propiedad, el instalador del cliente omite este valor.

• COMPRESS: almacena la memoria caché en un formato comprimido.

• FAILIFNOSPACE: si no hay suficiente espacio para instalar la memoria caché, quita el cliente de Administrador de configuración.

Ejemplo: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

Al actualizar un cliente existente, el instalador del cliente omite esta configuración. El cliente también ignora el tamaño de caché cuando descarga actualizaciones de software.

Ejemplo: CCMSetup.exe SMSCACHESIZE=100

SMSCONFIGSOURCE

Use esta propiedad para especificar la ubicación y el orden en que el instalador del cliente comprueba las opciones de configuración. Es una cadena de uno o más caracteres, cada uno de los cuales define un origen de configuración específico:

• R: comprueba las opciones de configuración en el registro.

  Para obtener más información, consulte Aprovisionar propiedades de instalación de cliente.

• P: comprueba los valores de configuración en las propiedades de instalación desde la línea de comandos.

• M: Comprueba la configuración existente al actualizar un cliente antiguo.

• U: actualiza el cliente instalado a una versión más reciente y usa el código de sitio asignado.

De forma predeterminada, el instalador del cliente usa PU. En primer lugar, comprueba las propiedades de instalación (P) y, a continuación, la configuración existente (U).

Ejemplo: CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMP

Especifica un punto de administración inicial para que lo use el cliente de Administrador de configuración.

Ejemplos:

• CCMSetup.exe SMSMP=smsmp01.contoso.com

• CCMSetup.exe SMSMP=https://smsmp01.contoso.com

SMSMPLIST

Especifica una lista de puntos de administración para que los use el cliente de Administrador de configuración. Use un punto y coma (;) como delimitador al especificar varios puntos de administración.

Ejemplos:

• CCMSetup.exe SMSMPLIST=https://smsmp01.contoso.com;https://smsmp02.contoso.com;smsmp03.contoso.com

• CCMSetup.exe SMSMPLIST=https://smsmp01.contoso.com;smsmp02.contoso.com;smsmp03.contoso.com

SMSPUBLICROOTKEY

Si el cliente no puede obtener la clave raíz de confianza de Administrador de configuración de Servicios de dominio de Active Directory, use esta propiedad para especificar la clave. Esta propiedad se aplica a los clientes que utilizan la comunicación HTTP y HTTPS. Para obtener más información, consulte Planeación de la clave raíz de confianza.

Ejemplo: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

SMSROOTKEYPATH

Use esta propiedad para reinstalar la clave raíz de confianza de Administrador de configuración. Especifica la ruta de acceso completa y el nombre de un archivo que contiene la clave raíz de confianza. Esta propiedad se aplica a los clientes que usan la comunicación de cliente HTTP y HTTPS. Para obtener más información, consulte Planeación de la clave raíz de confianza.

Ejemplo: CCMSetup.exe SMSROOTKEYPATH=C:\folder\trk

SMSSIGNCERT

Especifica la ruta de acceso completa y el nombre del certificado autofirmado exportado en el servidor del sitio. El servidor del sitio almacena este certificado en el almacén de certificados SMS . Tiene el nombre del Sujeto Servidor de sitio y el nombre descriptivo Certificado de firma de servidor de sitio.

Exporte el certificado sin la clave privada, almacene el archivo de forma segura y acceda a él solo desde un canal seguro.

Ejemplo: CCMSetup.exe /UsePKICert SMSSIGNCERT=C:\folder\smssign.cer

SMSSITECODE

Esta propiedad especifica el sitio de Administrador de configuración al que asigna el cliente. Este valor puede ser un código de sitio de tres caracteres o la palabra AUTO. Si especifica AUTOo no especifica esta propiedad, el cliente intentará determinar su asignación de sitio desde Servicios de dominio de Active Directory o desde un punto de administración especificado. Para habilitar AUTO las actualizaciones de cliente, establezca también SITEREASSIGN=TRUE.

Ejemplo: CCMSetup.exe SMSSITECODE=XZY

UPGRADETOLATEST

Esta propiedad obliga a CCMSetup a enviar una solicitud de ubicación al punto de administración para obtener la versión más reciente del origen de instalación del cliente de Administrador de configuración. Hay varios escenarios en los que esta propiedad es especialmente útil:

• Clientes de preproducción. Un cliente recién instalado usa la línea base de producción porque no puede evaluar la colección de preproducción hasta que se instala el cliente. En ese escenario, después de instalar el cliente y evaluar la directiva, se actualizará más tarde a la versión de cliente de preproducción. Use esta propiedad para que el dispositivo instale inmediatamente la versión más reciente del cliente.

  Este escenario también incluye el uso de Windows Autopilot en la administración conjunta. Use esta propiedad para asegurarse de que el dispositivo Windows Autopilot recién aprovisionado usa la versión de cliente de preproducción inmediatamente.

• Extraer puntos de distribución. Permita que los puntos de distribución de extracción instalen la versión de cliente más reciente, incluso si no está en la colección de preproducción. Esta acción garantiza que la versión del cliente en el punto de distribución de extracción es la misma que los archivos binarios del punto de distribución. Si estas versiones no son las mismas, puede causar problemas.

Valores de atributos para criterios de selección de certificados

Administrador de configuración admite los siguientes valores de atributo para los criterios de selección del certificado PKI:

Instalación de inserción de cliente

Si utiliza el método de instalación de inserción de cliente, utilice las opciones siguientes en la pestaña Cliente de las propiedades de instalación de inserción de cliente en la consola de Administrador de configuración:

• Cualquiera de las propiedades deClient.msi

• El siguiente subconjunto de parámetros de línea de comandos deCCMSetup.exe se permite para la inserción del cliente:

  • /AllowMetered (a partir de la versión 2103)

  • /AlwaysExcludeUpgrade

  • /BITSPriority

  • /downloadtimeout

  • /ExcludeFeatures

  • /forcereboot

  • /logon

  • /skipprereq

  • /UsePKICert