Comparteix a través de

Acerca de los parámetros y propiedades de instalación de cliente en Configuration Manager

  • Article

Se aplica a: Configuration Manager (rama actual)

Use el comando CCMSetup.exe para instalar el cliente de Configuration Manager. Si proporciona parámetros de instalación de cliente en la línea de comandos , modificarán el comportamiento de instalación. Si proporciona propiedades de instalación de cliente en la línea de comandos, modificarán la configuración inicial del agente 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. Estos archivos pueden incluir:

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

  • Requisitos previos del cliente

  • Novedades y correcciones para el cliente de Configuration Manager

Nota:

No se puede instalar directamente client.msi.

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 suelen ser minúsculas. Especifique el valor de un parámetro cuando sea necesario utilizando dos puntos (:) inmediatamente seguidos del valor. Para obtener más información, vea CCMSetup.exe parámetros de la 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 son mayúsculas. Especifique un valor para una propiedad con un signo igual (=) inmediatamente seguido del valor. Para obtener más información, vea Client.msi propiedades.

Importante

Especifique los parámetros de CCMSetup antes de especificar las propiedades de client.msi.

CCMSetup.exe y los archivos auxiliares se encuentran en el servidor de sitio en la carpeta Cliente de la carpeta de instalación Configuration Manager. Configuration Manager comparte esta carpeta en la red en el recurso compartido de sitio. Por ejemplo, \\SiteServer\SMS_ABC\Client.

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

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

Por ejemplo:

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

En este ejemplo se hace lo siguiente:

  • Especifica el punto de administración denominado SMSMP01 para solicitar una lista de puntos de distribución para 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 use el punto de estado de reserva denominado SMSFP01.

Sugerencia

Si un valor de parámetro tiene espacios, envuelvelo entre comillas.

Si extiende el esquema de Active Directory para Configuration Manager, el sitio publica muchas propiedades de instalación de cliente en Servicios de dominio de Active Directory. El cliente Configuration Manager 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. Al permitir la comunicación de cliente en una red de uso medido para ccmsetup, descarga el contenido, se registra en el sitio y descarga la directiva inicial. Cualquier comunicación de cliente adicional sigue la configuración del cliente de esa directiva. Para obtener más información, consulte Acerca de la configuración de cliente.

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 de ccmsetup

/AlwaysExcludeUpgrade

Este parámetro especifica si un cliente se actualizará automáticamente al habilitar la actualización automática del 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.

Nota:

Cuando se usa el /AlwaysExcludeUpgrade parámetro , se sigue ejecutando la actualización automática. Sin embargo, cuando CCMSetup se ejecuta para realizar la actualización, observará que /AlwaysExcludeUpgrade el parámetro se ha establecido y registrará la siguiente línea en ccmsetup.log:

Client is stamped with /alwaysexcludeupgrade. Stop proceeding.

CCMSetup se cerrará inmediatamente y no realizará la actualización.

/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 (valor 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 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, use el archivo mobileclienttemplate.tcf en la \bin\<platform> carpeta del directorio de instalación Configuration Manager en el servidor de sitio. Este archivo tiene comentarios sobre las secciones y cómo usarlas. Especifique las propiedades de instalación del cliente en la [Client Install] sección , después del texto siguiente: Install=INSTALL=ALL.

Entrada de sección de ejemplo [Client Install] : 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).

Use el /retry parámetro para especificar el intervalo entre 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.

Nota:

ClientUI es el único valor que admite el /ExcludeFeatures parámetro.

/forceinstall

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

/forcereboot

Use 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 cierra cuando es necesario reiniciar. A continuación, continúa después del siguiente reinicio manual.

Ejemplo: CCMSetup.exe /forcereboot

/logon

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

Ejemplo: ccmsetup.exe /logon

/mp

Especifica un punto de administración para que los clientes usen para buscar el punto de distribución más cercano para los archivos de instalación de 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 ccmsetup descarga contenido, consulte Grupos de límites: instalación de cliente. En ese artículo también se incluyen detalles del comportamiento de ccmsetup si usa parámetros /mp y /source .

Importante

Este parámetro especifica un punto de administración inicial para que los equipos encuentren un origen de descarga y puede ser cualquier punto de administración en cualquier sitio. No asigna el cliente al punto de administración especificado.

Los equipos descargan los archivos a través de una conexión HTTP o HTTPS, en función de la configuración del rol de sistema de 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 puntos de administración solo para conexiones de cliente HTTPS, compruebe que el equipo cliente tiene un certificado de cliente válido.

Puede usar el parámetro de línea /mp de comandos para especificar más de un punto de administración. Si el equipo no se conecta al primero, intenta el siguiente en la lista especificada. Cuando especifique varios puntos de administración, separe los valores por punto y coma.

Si el cliente se conecta a un punto de administración mediante HTTPS, especifique el FQDN y no el nombre del equipo. El valor debe coincidir con el firmante o el nombre alternativo del firmante del certificado PKI del punto de administración. Aunque Configuration Manager 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:

  • Cree una instancia de CMG. Para obtener más información, consulte Configuración de una instancia de CMG.

  • En un cliente activo, abra un símbolo del sistema 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 para cuando se usa la dirección URL de la puerta de enlace de administración en la nube: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

Importante

Al especificar la dirección URL de una puerta de enlace de administración en la nube para el /mp parámetro , debe empezar por https://.

Nota:

El parámetro de línea de comandos /mp no especifica el punto de administración utilizado por el cliente Configuration Manager una vez instalado. Para especificar el punto de administración inicial utilizado por el cliente de Configuration Manager una vez instalado, use la propiedad client.msi SMSMP. Para especificar una lista de puntos de administración para que el cliente Configuration Manager use una vez instalado, use la propiedad client.msi SMSMPLIST.

/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. Cuando no se 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 de cliente, consulte Planeamiento de la revocación de certificados PKI.

Ejemplo: CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

Este parámetro impide que CCMSetup se ejecute como servicio, lo que hace de forma predeterminada. Cuando CCMSetup se ejecuta como servicio, se ejecuta en el contexto de la cuenta del 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 se 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 siguientes parámetros y propiedades:

En la línea de comandos de ejemplo siguiente se incluyen los demás parámetros y propiedades 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

Sugerencia

Si CCMSetup devuelve 0x87d0027e de error, intente quitar el /mp parámetro de la línea de comandos.

/retry

Si CCMSetup.exe no puede descargar archivos de instalación, use este parámetro para especificar el intervalo de reintentos en minutos. CCMSetup continúa reintentar 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 usa la cuenta del sistema local.

Sugerencia

Si usa un script para ejecutar CCMSetup.exe con el /service parámetro , CCMSetup.exe se cierra después de que se inicie el servicio. Es posible que no informe correctamente de los detalles de la instalación al script.

Ejemplo: ccmsetup.exe /service

/skipprereq

Este parámetro especifica que CCMSetup.exe no instala el requisito previo especificado. Puede escribir 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 de cliente, consulte Requisitos previos de cliente de Windows.

/source

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

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

Sugerencia

Puede usar el /source parámetro más de una vez en una línea de comandos para especificar ubicaciones de descarga alternativas.

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

/uninstall

Use este parámetro para desinstalar el cliente de Configuration Manager. Para obtener más información, vea Desinstalar el cliente.

Ejemplo: ccmsetup.exe /uninstall

Nota:

A partir de la versión 2111, al desinstalar el cliente, también quita el arranque del cliente, ccmsetup.msi, si existe.

/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, filtra todos los puntos de administración HTTPS, incluidas las puertas de enlace de administración en la nube (CMG). El cliente usa 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 Microsoft Entra información de incorporación de una puerta de enlace de administración en la nube (CMG). Para un cliente que usa Microsoft Entra autenticación, no especifique este parámetro, pero incluya las propiedades AADRESOURCEURI y AADCLIENTAPPID.

Nota:

En algunos escenarios, no es necesario especificar este parámetro, pero sigue usando un certificado de cliente. Por ejemplo, la inserción de cliente y la instalación de cliente basada en actualizaciones de software. Use este parámetro cuando instale manualmente un cliente y use el /mp parámetro con un punto de administración habilitado para HTTPS.

Especifique también este parámetro al instalar un cliente para la comunicación solo de Internet. Use CCMALWAYSINF=1 junto con las propiedades para el punto de administración basado en Internet (CCMHOSTNAME) y el código de sitio (SMSSITECODE). Para obtener más información sobre la administración de clientes basada en Internet, vea Consideraciones sobre las comunicaciones de cliente desde Internet o un bosque que no es de confianza.

/IgnoreSkipUpgrade

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

CCMSetup.exe códigos de retorno

El comando CCMSetup.exe proporciona los siguientes códigos de retorno. Para solucionar problemas, revise %WinDir%\ccmsetup\Logs\ccmsetup.log en el cliente el contexto y detalles adicionales sobre los códigos de retorno.

Código devuelto Significado
0 Correcto
6 Error
7 Reinicio necesario
8 El programa de instalación ya se está ejecutando
9 Error de evaluación de requisitos previos
10 Error de validación de hash del manifiesto de instalación

propiedades de Ccmsetup.msi

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

CCMSETUPCMD

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

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

Sugerencia

Microsoft Intune limita la línea de comandos a 1024 caracteres.

propiedades de Client.msi

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

AADCLIENTAPPID

Especifica el identificador de la aplicación cliente Microsoft Entra. La aplicación cliente se crea o importa al configurar los servicios de Azure para Cloud Management. Un administrador de Azure puede obtener el valor de esta propiedad de la Azure Portal. Para obtener más información, consulte Obtención del identificador de la 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 aplicación de servidor Microsoft Entra. La aplicación de servidor se crea o importa al configurar los servicios de Azure para Cloud Management. Al crear la aplicación de servidor, en la ventana Crear aplicación de servidor, esta propiedad es el URI del identificador de aplicación.

Un administrador de Azure puede obtener el valor de esta propiedad de la Azure Portal. En Microsoft Entra id., busque la aplicación de 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 del URI del identificador de aplicación para esta AADRESOURCEURI propiedad de instalación de cliente.

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

AADTENANTID

Especifica el identificador de inquilino Microsoft Entra. Configuration Manager vínculos 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 se ejecuta Windows 10 o posterior y se une al mismo inquilino 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 : 607b7853-6f6f-4d5d-b3d4-811c33fdd49a

    Nota:

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

Ejemplo: ccmsetup.exe AADTENANTID=607b7853-6f6f-4d5d-b3d4-811c33fdd49a

CCMADMINS

Especifica una o varias cuentas de usuario o grupos de Windows a los que se les va a conceder 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, permita que el equipo se reinicie silenciosamente después de la instalación del cliente.

Importante

Cuando se usa esta propiedad, el equipo se reinicia sin previo aviso. Este comportamiento se produce incluso si un usuario ha iniciado sesión en Windows.

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 1de propiedad en . El tipo de conexión del cliente muestra Always Internet.

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

Para obtener más información sobre la administración de clientes basada en Internet, vea Consideraciones sobre 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

Use esta propiedad para especificar la lista de emisores de certificados. Esta lista incluye información de certificado para las entidades de certificación raíz (CA) de confianza en las que confía el sitio Configuration Manager.

Este valor es una coincidencia que distingue mayúsculas de minúsculas para los atributos de asunto que se encuentran en el certificado de entidad de certificación raíz. Separe los atributos mediante una coma (,) o un punto y coma (;). Especifique más de un certificado de entidad de certificación 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."

Sugerencia

Use el valor del atributo CertificateIssuers en el archivo mobileclient.tcf del sitio. Este archivo se encuentra en la \bin\<platform> subcarpeta del directorio de instalación de Configuration Manager en el servidor de sitio.

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

CCMCERTNAMECHECK

A partir de la versión 2207, esta propiedad se puede usar para omitir la comprobación del nombre del firmante del 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 que seleccione un certificado de autenticación de cliente válido.

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

  • Subject: búsqueda de una coincidencia exacta
  • SubjectStr: búsqueda de 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 el nombre alternativo del firmante.

  • CCMCERTSEL="SubjectStr:contoso.com": busque un certificado que contenga contoso.com el nombre del firmante o el nombre alternativo del firmante.

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

Ejemplos:

  • CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": busque el atributo de unidad organizativa expresado como identificador de objeto y denominado Computers.

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

Importante

Si usa el nombre del firmante, la Subject palabra clave distingue mayúsculas de minúsculas y la SubjectStr palabra clave no distingue mayúsculas de minúsculas.

Si usa el nombre alternativo del firmante, las Subject palabras clave y SubjectStr no distinguen mayúsculas de minúsculas.

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 se establece en CCMFIRSTCERT1, el instalador de cliente selecciona el certificado con el período de validez más largo.

CCMCERTSTORE

Si el instalador de cliente no puede encontrar un certificado válido en el almacén de certificados personal predeterminado 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 se instala el cliente. Esta propiedad hace que el cliente registre información de bajo nivel para solucionar problemas. Evite usar esta propiedad en sitios de producción. Puede producirse un registro excesivo, lo que podría dificultar la búsqueda de información relevante en los archivos de registro. CCMENABLELOGGINGHabilite también .

Valores admitidos:

  • 0: desactivar el registro de depuración (valor 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

Configuration Manager habilita el registro de forma predeterminada.

Valores admitidos:

  • TRUE: activar el registro (valor predeterminado)
  • FALSE: desactivar el registro

Ejemplo: CCMSetup.exe CCMENABLELOGGING=TRUE

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

CCMEVALINTERVAL

Frecuencia en minutos en que se ejecuta la herramienta de evaluación de estado del cliente (ccmeval.exe). Especifique un valor entero de 1 a 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

Hora durante el día en que se ejecuta la herramienta de evaluación de estado del cliente (ccmeval.exe). Especifique un valor entero de 0 (medianoche) a 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 1en , 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 FQDN 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:

  • Cree una instancia de CMG. Para obtener más información, consulte Configuración de una instancia de CMG.

  • En un cliente activo, abra un símbolo del sistema 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 como está con la CCMHOSTNAME propiedad .

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

Importante

Cuando especifique la dirección de un CMG para la CCMHOSTNAME propiedad , no anexe un prefijo como https://. Use solo este prefijo con la /mp dirección URL de un CMG.

CCMHTTPPORT

Especifica el puerto que el cliente debe usar cuando se comunica a través de 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 el cliente debe usar cuando se comunica a través de HTTPS con los servidores del sistema de 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 Configuration Manager. De forma predeterminada, usa %WinDir%\CCM.

Sugerencia

Independientemente de dónde instale los archivos de cliente, siempre instala el archivo ccmcore.dll en la %WinDir%\System32 carpeta . En un sistema operativo de 64 bits, instala una copia de ccmcore.dll en la %WinDir%\SysWOW64 carpeta . Este archivo admite aplicaciones de 32 bits que usan la versión de 32 bits de las API cliente del SDK de Configuration Manager.

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

CCMLOGLEVEL

Use esta propiedad para especificar el nivel de detalle que se va a escribir en Configuration Manager archivos de registro.

Valores admitidos:

  • 0:Detallado
  • 1: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 Configuration Manager alcanza el tamaño máximo, el cliente lo cambia de nombre como copia de seguridad y crea un nuevo archivo de registro. Esta propiedad especifica cuántas versiones anteriores del archivo de registro se deben conservar. El valor predeterminado es 1. Si establece el valor en 0, el cliente no conserva 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 cambia de nombre como un archivo de historial y crea uno nuevo. El tamaño predeterminado es de 250 000 bytes y el tamaño mínimo es de 10 000 bytes.

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

DISABLESITEOPT

Establezca esta propiedad TRUE en para impedir que los administradores cambien el sitio asignado en el panel de control de Configuration Manager.

Ejemplo: CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

Si se establece en TRUE, esta propiedad deshabilita la capacidad de los usuarios administrativos de cambiar la configuración de la carpeta de caché de cliente en el panel de control Configuration Manager.

Ejemplo: CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIX

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

Nota:

No es necesario especificar esta propiedad si el cliente está en el mismo dominio que un punto de administración publicado. En ese caso, el dominio del cliente se usa automáticamente para buscar puntos de administración en DNS.

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

Nota:

De forma predeterminada, Configuration Manager no habilita la publicación de DNS.

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 Configuration Manager clientes.

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

Ejemplo: CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

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

Importante

Si instala el cliente de Configuration Manager sin instalar App-V, no podrá implementar aplicaciones virtuales.

Ejemplo: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

MANAGEDINSTALLER

Si establece esta propiedad 1 en , 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 Windows Defender Control de aplicaciones.

Ejemplo: CCMSetup.exe MANAGEDINSTALLER=1

NOTIFYONLY

Al habilitar 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 Configuración del estado del cliente.

PROVISIONTS

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

Nota:

Si la secuencia de tareas instala aplicaciones o actualizaciones de software, los clientes necesitan un certificado de autenticación de cliente válido. La autenticación de tokens por sí sola no funciona.

Por ejemplo, aprovisiona un nuevo dispositivo Windows con Windows Autopilot, lo inscribe automáticamente en Microsoft Intune y, a continuación, instala el cliente Configuration Manager para la administración conjunta. Si especifica esta nueva opción, el cliente recién aprovisionado ejecuta una secuencia de tareas. Este proceso proporciona flexibilidad adicional para instalar aplicaciones y actualizaciones de software, o configurar la configuración.

Use el proceso siguiente:

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

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

    Sugerencia

    El propósito de la implementación puede estar disponible o ser necesario. Dado que especifica el identificador de implementación como valor de propiedad, el propósito no importa.

  3. Instale el cliente Configuration Manager en un dispositivo mediante ccmsetup.msie incluya la siguiente propiedad: PROVISIONTS=PRI20001. Establezca el valor de esta propiedad como 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 Preparación de 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 identificador o crear una puerta de enlace de administración en la nube habilitada para contenido.

      Independientemente del método , use solo esta propiedad 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 de cliente, no se iniciará la secuencia de tareas.

Nota:

La secuencia de tareas iniciada por PROVISIONTS usa la configuración de cliente predeterminada. Esta secuencia de tareas se inicia inmediatamente después de que el cliente se registre, por lo que no formará parte de ninguna colección en la que haya implementado la configuración de cliente personalizada. El cliente no procesa ni aplica la configuración de cliente personalizada antes de que se ejecute esta secuencia de tareas.

Para que la secuencia de tareas funcione correctamente, es posible que tenga que cambiar cierta configuración en Configuración de cliente predeterminada. Por ejemplo:

  • Cloud Services grupo: permitir que los clientes usen una puerta de enlace de administración en la nube y permitir el acceso al punto de distribución de nube
  • Grupo agente de equipo : directiva de ejecución de PowerShell

Si los dispositivos no necesitan esta configuración de cliente una vez completada la secuencia de tareas, implemente una nueva configuración de cliente personalizada para invertir la configuración predeterminada.

Para obtener más información, consulte Acerca de la configuración de cliente.

RESETKEYINFORMATION

Si un cliente tiene la clave raíz de confianza Configuration Manager incorrecta, no puede 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 clave raíz de confianza antigua. Esta situación puede producirse cuando se mueve 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 Planeamiento 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 cliente 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 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 de 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 más detalles de instalación para la carpeta de caché de cliente. Puede usar SMSCACHEFLAGS propiedades individualmente o en combinación separadas por punto y coma (;).

Si no incluye esta propiedad:

  • El cliente instala la carpeta de caché según la SMSCACHEDIR propiedad
  • La carpeta no está comprimida
  • El cliente usa la SMSCACHESIZE propiedad como 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: establezca el tamaño de caché como porcentaje del espacio total en disco. Si especifica esta propiedad, establezca también en SMSCACHESIZE un valor de porcentaje.

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

  • MAXDRIVE: instale la memoria caché en el disco disponible más grande. 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 el espacio más libre. Si especifica una ruta de acceso con la SMSCACHEDIR propiedad , el instalador del cliente omite este valor.

  • NTFSONLY: instale solo 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: almacene la memoria caché en un formulario comprimido.

  • FAILIFNOSPACE: si no hay espacio suficiente para instalar la memoria caché, quite el cliente de Configuration Manager.

Ejemplo: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

Importante

La configuración de cliente está disponible para especificar el tamaño de la carpeta de caché de cliente. La adición de esa configuración de cliente reemplaza eficazmente el uso de SMSCACHESIZE como una propiedad client.msi para especificar el tamaño de la memoria caché del cliente. Para obtener más información, consulte la configuración del cliente para el tamaño de caché.

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

Ejemplo: CCMSetup.exe SMSCACHESIZE=100

Nota:

Si vuelve a instalar un cliente, no puede usar SMSCACHESIZE ni SMSCACHEFLAGS establecer el tamaño de caché para que sea menor que antes. El tamaño anterior es el valor mínimo.

SMSCONFIGSOURCE

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

  • R: compruebe si hay opciones de configuración en el Registro.

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

  • P: compruebe si hay opciones de configuración en las propiedades de instalación desde la línea de comandos.

  • M: compruebe la configuración existente al actualizar un cliente anterior.

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

De forma predeterminada, el instalador de cliente usa PU. Primero 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 el cliente de Configuration Manager que se va a usar.

Importante

Si el punto de administración solo acepta conexiones de cliente a través de HTTPS, anteponga el nombre del punto de administración a https://.

Ejemplos:

  • CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSMPLIST

Especifica una lista de puntos de administración para el cliente de Configuration Manager que se va a usar. Use un punto y coma (;) como delimitador al especificar varios puntos de administración.

Importante

Si el punto de administración solo acepta conexiones de cliente a través de HTTPS, anteponga el nombre del punto de administración a https://.

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 el Configuration Manager clave raíz de confianza de Servicios de dominio de Active Directory, use esta propiedad para especificar la clave. Esta propiedad se aplica a los clientes que usan la comunicación HTTP y HTTPS. Para obtener más información, consulte Planeamiento de la clave raíz de confianza.

Ejemplo: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

Sugerencia

Obtenga el valor de la clave raíz de confianza del sitio desde el archivo mobileclient.tcf en el servidor de sitio. Para obtener más información, consulte Aprovisionamiento previo de un cliente con la clave raíz de confianza mediante un archivo.

SMSROOTKEYPATH

Use esta propiedad para volver a instalar la clave raíz de confianza Configuration Manager. 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 Planeamiento 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 de sitio. El servidor de sitio almacena este certificado en el almacén de certificados SMS . Tiene el nombre de firmante Servidor de sitio y el nombre descriptivo Certificado de firma del servidor de sitio.

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

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

SMSSITECODE

Esta propiedad especifica un sitio Configuration Manager al que se 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 intenta 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.

Nota:

Si también especifica un punto de administración basado en Internet con la CCMHOSTNAME propiedad , no use AUTO con SMSSITECODE. Asigne directamente el cliente a su sitio especificando el código del sitio.

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 Configuration Manager. 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á posteriormente 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 Autopilot en la administración conjunta. Use esta propiedad para asegurarse de que el dispositivo Autopilot recién aprovisionado usa la versión de cliente de preproducción inmediatamente.

  • Puntos de distribución de extracción. Permitir que los puntos de distribución de extracción instalen la versión de cliente más reciente aunque 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 sea la misma que los archivos binarios del punto de distribución. Si estas versiones no son las mismas, puede causar problemas.

Valores de atributo para los criterios de selección de certificados

Configuration Manager admite los siguientes valores de atributo para los criterios de selección de certificados PKI:

Atributo OID Atributo Distinguished Name Definición de atributo
0.9.2342.19200300.100.1.25 DC Componente de dominio
1.2.840.113549.1.9.1 E o correo electrónico Dirección de correo electrónico
2.5.4.3 CN Nombre común
2.5.4.4 SN Nombre de sujeto
2.5.4.5 SERIALNUMBER Número de serie
2.5.4.6 C Código de país
2.5.4.7 L Localidad
2.5.4.8 S o ST Nombre de estado o provincia
2.5.4.9 CALLE Dirección
2.5.4.10 O Nombre de la organización
2.5.4.11 OU Unidad organizativa
2.5.4.12 T o Title Cargo
2.5.4.42 G o GN o GivenName Nombre dado
2.5.4.43 I o Iniciales Initials
2.5.29.17 (sin valor) Nombre alternativo del firmante

Instalación de inserción de cliente

Si usa el método de instalación de inserción de cliente, use las siguientes opciones en la pestaña Cliente de propiedades de instalación de inserción de cliente en la consola de Configuration Manager: