Compartilhar via

Sobre parâmetros e propriedades de instalação do cliente no Configuration Manager

  • Artigo

Aplica-se a: Configuration Manager (branch atual)

Use o comando CCMSetup.exe para instalar o cliente Configuration Manager. Se você fornecer parâmetros de instalação do cliente na linha de comando, eles modificarão o comportamento de instalação. Se você fornecer propriedades de instalação do cliente na linha de comando, elas modificarão a configuração inicial do agente cliente instalado.

Sobre CCMSetup.exe

O comando CCMSetup.exe baixa arquivos necessários para instalar o cliente de um ponto de gerenciamento ou de um local de origem. Esses arquivos podem incluir:

  • O pacote do Windows Installer client.msi que instala o software cliente

  • Pré-requisitos do cliente

  • Atualizações e correções para o cliente Configuration Manager

Observação

Você não pode instalar diretamente client.msi.

CCMSetup.exe fornece parâmetros de linha de comando para personalizar a instalação. Os parâmetros são prefixados com uma barra (/) e geralmente são minúsculas. Especifique o valor de um parâmetro quando necessário usando um ponto (:) imediatamente seguido pelo valor. Para obter mais informações, consulte CCMSetup.exe parâmetros de linha de comando.

Você também pode fornecer propriedades na linha de comando CCMSetup.exe para modificar o comportamento de client.msi. As propriedades por convenção são maiúsculas. Você especifica um valor para uma propriedade usando um sinal igual (=) imediatamente seguido pelo valor. Para obter mais informações, consulte Client.msi propriedades.

Importante

Especifique parâmetros CCMSetup antes de especificar propriedades para client.msi.

CCMSetup.exe e os arquivos de suporte estão no servidor do site na pasta Cliente da pasta de instalação Configuration Manager. Configuration Manager compartilha essa pasta para a rede no compartilhamento do site. Por exemplo, \\SiteServer\SMS_ABC\Client.

No prompt de comando, o comando CCMSetup.exe usa o seguinte formato:

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

Por exemplo:

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

Este exemplo faz as seguintes coisas:

  • Especifica o ponto de gerenciamento chamado SMSMP01 para solicitar uma lista de pontos de distribuição para baixar os arquivos de instalação do cliente.

  • Especifica que a instalação deve ser interrompida se uma versão do cliente já existir no computador.

  • Instrui client.msi a atribuir o cliente ao código do site S01.

  • Instrui client.msi a usar o ponto de status de fallback chamado SMSFP01.

Dica

Se um valor de parâmetro tiver espaços, cerque-o com aspas.

Se você estender o esquema do Active Directory para Configuration Manager, o site publicará muitas propriedades de instalação do cliente no Active Directory Domain Services. O cliente Configuration Manager lê automaticamente essas propriedades. Para obter mais informações, consulte Sobre as propriedades de instalação do cliente publicadas em Active Directory Domain Services

CCMSetup.exe parâmetros de linha de comando

/?

Mostra parâmetros de linha de comando disponíveis para ccmsetup.exe.

Exemplo: ccmsetup.exe /?

/AllowMetered

Use esse parâmetro para controlar o comportamento do cliente em uma rede limitada. Esse parâmetro não usa valores. Quando você permite a comunicação do cliente em uma rede limitada para ccmsetup, ele baixa o conteúdo, registra com o site e baixa a política inicial. Qualquer comunicação adicional do cliente segue a configuração da configuração do cliente a partir dessa política. Para obter mais informações, consulte Sobre as configurações do cliente.

Se você reinstalar o cliente em um dispositivo existente, ele usará a seguinte prioridade para determinar sua configuração:

  1. Política de cliente local existente
  2. A última linha de comando armazenada no registro do Windows
  3. Parâmetros na linha de comando ccmsetup

/AlwaysExcludeUpgrade

Esse parâmetro especifica se um cliente fará ou não a atualização automática ao habilitar a atualização automática do cliente.

Valores com suporte:

  • TRUE: o cliente não atualizará automaticamente
  • FALSE: o cliente atualiza automaticamente (padrão)

Por exemplo:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

Para obter mais informações, consulte Cliente de interoperabilidade estendida.

Observação

Ao usar o /AlwaysExcludeUpgrade parâmetro, a atualização automática ainda é executada. No entanto, quando o CCMSetup for executado para executar a atualização, ele observará que /AlwaysExcludeUpgrade o parâmetro foi definido e registrará a seguinte linha no ccmsetup.log:

Client is stamped with /alwaysexcludeupgrade. Stop proceeding.

O CCMSetup sairá imediatamente e não executará a atualização.

/BITSPriority

Quando o dispositivo baixar arquivos de instalação do cliente em uma conexão HTTP, use esse parâmetro para especificar a prioridade de download. Especifique um dos seguintes valores possíveis:

  • FOREGROUND

  • HIGH

  • NORMAL (padrão)

  • LOW

Exemplo: ccmsetup.exe /BITSPriority:HIGH

/config

Esse parâmetro especifica um arquivo de texto que lista as propriedades de instalação do cliente.

  • Se o CCMSetup for executado como um serviço, coloque esse arquivo na pasta do sistema CCMSetup: %Windir%\Ccmsetup.

  • Se você especificar o /noservice parâmetro, coloque esse arquivo na mesma pasta que CCMSetup.exe.

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

Para fornecer o formato de arquivo correto, use o arquivo mobileclienttemplate.tcf na \bin\<platform> pasta no diretório de instalação Configuration Manager no servidor do site. Este arquivo tem comentários sobre as seções e como usá-las. Especifique as propriedades de instalação do [Client Install] cliente na seção, após o seguinte texto: Install=INSTALL=ALL.

Entrada de seção de exemplo [Client Install] : Install=INSTALL=ALL SMSSITECODE=ABC SMSCACHESIZE=100

/downloadtimeout

Se CCMSetup não baixar os arquivos de instalação do cliente, esse parâmetro especificará o tempo limite máximo em minutos. Após esse tempo limite, o CCMSetup para de tentar baixar os arquivos de instalação. O valor padrão é de 1440 minutos (um dia).

Use o /retry parâmetro para especificar o intervalo entre tentativas de repetição.

Exemplo: ccmsetup.exe /downloadtimeout:100

/ExcludeFeatures

Esse parâmetro especifica que CCMSetup.exe não instala o recurso especificado.

Exemplo: CCMSetup.exe /ExcludeFeatures:ClientUI não instala o Centro de Software no cliente.

Observação

ClientUI é o único valor que o /ExcludeFeatures parâmetro dá suporte.

/forceinstall

Especifique que CCMSetup.exe desinstale qualquer cliente existente e instale um novo cliente.

/forcereboot

Use esse parâmetro para forçar o computador a reiniciar, se necessário, para concluir a instalação. Se você não especificar esse parâmetro, CCMSetup sairá quando uma reinicialização é necessária. Em seguida, ele continua após a próxima reinicialização manual.

Exemplo: CCMSetup.exe /forcereboot

/logon

Se alguma versão do cliente já estiver instalada, esse parâmetro especificará que a instalação do cliente deve parar.

Exemplo: ccmsetup.exe /logon

/mp

Especifica um ponto de gerenciamento para os clientes usarem para localizar o ponto de distribuição mais próximo para os arquivos de instalação do cliente. Se não houver pontos de distribuição ou os computadores não puderem baixar os arquivos dos pontos de distribuição após quatro horas, eles baixarão os arquivos do ponto de gerenciamento especificado.

Para obter mais informações sobre como o ccmsetup baixa conteúdo, consulte Grupos de limites – instalação do cliente. Esse artigo também inclui detalhes do comportamento ccmsetup se você usar parâmetros e /source ambos/mp.

Importante

Esse parâmetro especifica um ponto de gerenciamento inicial para computadores encontrarem uma origem de download e pode ser qualquer ponto de gerenciamento em qualquer site. Ele não atribui o cliente ao ponto de gerenciamento especificado.

Os computadores baixam os arquivos em uma conexão HTTP ou HTTPS, dependendo da configuração de função do sistema de site para conexões de cliente. O download também pode usar a limitação do BITS se você configurá-lo. Se você configurar todos os pontos de distribuição e pontos de gerenciamento somente para conexões de cliente HTTPS, verifique se o computador cliente tem um certificado de cliente válido.

Você pode usar o /mp parâmetro de linha de comando para especificar mais de um ponto de gerenciamento. Se o computador não se conectar ao primeiro, ele tentará o próximo na lista especificada. Ao especificar vários pontos de gerenciamento, separe os valores por ponto e vírgula.

Se o cliente se conectar a um ponto de gerenciamento usando HTTPS, especifique o FQDN e não o nome do computador. O valor deve corresponder ao ponto de gerenciamento nome alternativo do certificado PKI ou assunto. Embora Configuration Manager dê suporte ao uso de um nome de computador no certificado para conexões na intranet, é recomendável usar um FQDN.

Exemplo com o nome do computador: ccmsetup.exe /mp:SMSMP01

Exemplo com o FQDN: ccmsetup.exe /mp:smsmp01.contoso.com

Esse parâmetro também pode especificar a URL de um CMG (gateway de gerenciamento de nuvem). Use essa URL para instalar o cliente em um dispositivo baseado na Internet. Para obter o valor desse parâmetro, use as seguintes etapas:

  • Crie um CMG. Para obter mais informações, consulte Configurar um CMG.

  • Em um cliente ativo, abra um prompt de comando Windows PowerShell como administrador.

  • Execute o seguinte comando:

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

  • Anexe o https:// prefixo a ser usado com o /mp parâmetro.

Exemplo para quando você usa a URL do gateway de gerenciamento de nuvem: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

Importante

Ao especificar a URL de um gateway de gerenciamento de nuvem para o /mp parâmetro, ele deve começar com https://.

Observação

O parâmetro de linha de comando /mp não especifica o ponto de gerenciamento usado pelo cliente Configuration Manager depois de instalado. Para especificar o ponto de gerenciamento inicial usado pelo cliente Configuration Manager depois de instalado, use a propriedade client.msi SMSMP. Para especificar uma lista de pontos de gerenciamento para o cliente Configuration Manager usar depois de instalado, use a propriedade SMSMPLIST client.msi.

/NoCRLCheck

Especifica que um cliente não deve marcar a CRL (lista de revogação de certificado) quando se comunica por HTTPS com um certificado PKI. Quando você não especifica esse parâmetro, o cliente verifica o CRL antes de estabelecer uma conexão HTTPS. Para obter mais informações sobre a verificação de CRL do cliente, consulte Planejamento para revogação de certificado PKI.

Exemplo: CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

Esse parâmetro impede que o CCMSetup seja executado como um serviço, o que ele faz por padrão. Quando o CCMSetup é executado como um serviço, ele é executado no contexto da conta do Sistema Local do computador. Essa conta pode não ter direitos suficientes para acessar os recursos de rede necessários para a instalação. Com /noserviceo , CCMSetup.exe é executado no contexto da conta de usuário que você usa para iniciar a instalação.

Exemplo: ccmsetup.exe /noservice

/regtoken

Use esse parâmetro para fornecer um token de registro em massa. Um dispositivo baseado na Internet usa esse token no processo de registro por meio de um CMG (gateway de gerenciamento de nuvem). Para obter mais informações, consulte Autenticação baseada em token para CMG.

Ao usar esse parâmetro, inclua também os seguintes parâmetros e propriedades:

A linha de comando de exemplo a seguir inclui os outros parâmetros e propriedades de instalação necessários:

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

Dica

Se CCMSetup retornar o erro 0x87d0027e, tente remover o /mp parâmetro da linha de comando.

/retry

Se CCMSetup.exe não baixar arquivos de instalação, use esse parâmetro para especificar o intervalo de repetição em minutos. O CCMSetup continua a tentar novamente até atingir o limite especificado no /downloadtimeout parâmetro.

Exemplo: ccmsetup.exe /retry:20

/service

Especifica que o CCMSetup deve ser executado como um serviço que usa a conta do Sistema Local.

Dica

Se você estiver usando um script para executar CCMSetup.exe com o /service parâmetro, CCMSetup.exe sairá após o início do serviço. Ele pode não relatar corretamente os detalhes da instalação para o script.

Exemplo: ccmsetup.exe /service

/skipprereq

Esse parâmetro especifica que CCMSetup.exe não instala o pré-requisito especificado. Você pode inserir mais de um valor. Use o caractere ponto-e-vírgula (;) para separar cada valor.

Exemplos:

  • CCMSetup.exe /skipprereq:filename.exe

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

Para obter mais informações sobre os pré-requisitos do cliente, consulte Pré-requisitos do cliente do Windows.

/source

Especifica o local de download do arquivo. Use um caminho local ou UNC. O dispositivo baixa arquivos usando o protocolo SMB (bloco de mensagens do servidor). Para usar /source, a conta de usuário do Windows para instalação do cliente precisa de permissões de leitura para o local.

Para obter mais informações sobre como o ccmsetup baixa conteúdo, consulte Grupos de limites – instalação do cliente. Esse artigo também inclui detalhes do comportamento ccmsetup se você usar parâmetros e /source ambos/mp.

Dica

Você pode usar o /source parâmetro mais de uma vez em uma linha de comando para especificar locais de download alternativos.

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

/uninstall

Use esse parâmetro para desinstalar o cliente Configuration Manager. Para obter mais informações, consulte Desinstalar o cliente.

Exemplo: ccmsetup.exe /uninstall

Observação

A partir da versão 2111, quando você desinstala o cliente, ele também remove a inicialização do cliente, ccmsetup.msi, se ele existir.

/UsePKICert

Especifique esse parâmetro para o cliente usar um certificado de autenticação de cliente PKI. Se você não incluir esse parâmetro ou se o cliente não conseguir encontrar um certificado válido, ele filtra todos os pontos de gerenciamento HTTPS, incluindo gateways de gerenciamento de nuvem (CMG). O cliente usa uma conexão HTTP com um certificado autoassinado.

Exemplo: CCMSetup.exe /UsePKICert

Se um dispositivo usar Microsoft Entra ID para autenticação do cliente e também tiver um certificado de autenticação de cliente baseado em PKI, se você usar incluir esse parâmetro, o cliente não poderá obter Microsoft Entra informações de integração de um CMG (gateway de gerenciamento de nuvem). Para um cliente que usa Microsoft Entra autenticação, não especifique esse parâmetro, mas inclua as propriedades AADRESOURCEURI e AADCLIENTAPPID.

Observação

Em alguns cenários, você não precisa especificar esse parâmetro, mas ainda usar um certificado de cliente. Por exemplo, push do cliente e instalação de cliente baseada em atualização de software. Use esse parâmetro quando instalar manualmente um cliente e usar o /mp parâmetro com um ponto de gerenciamento habilitado para HTTPS.

Especifique também esse parâmetro ao instalar um cliente para comunicação somente na Internet. Use CCMALWAYSINF=1 junto com as propriedades para o ponto de gerenciamento baseado na Internet (CCMHOSTNAME) e o código do site (SMSSITECODE). Para obter mais informações sobre o gerenciamento de clientes baseado na Internet, consulte Considerações sobre comunicações de cliente da Internet ou de uma floresta não confiável.

/IgnoreSkipUpgrade

Especifique esse parâmetro para atualizar manualmente um cliente excluído. Para obter mais informações, consulte Como excluir clientes da atualização.

CCMSetup.exe códigos de retorno

O comando CCMSetup.exe fornece os seguintes códigos de retorno. Para solucionar problemas, examine %WinDir%\ccmsetup\Logs\ccmsetup.log o cliente para obter contexto e detalhes adicionais sobre códigos retornados.

Retornar código Significado
0 Êxito
6 Erro
7 Reinicialização necessária
8 Configuração já em execução
9 Falha na avaliação do pré-requisito
10 Falha de validação de hash do manifesto de instalação

Ccmsetup.msi propriedades

As propriedades a seguir podem modificar o comportamento de instalação de ccmsetup.msi.

CCMSETUPCMD

Use este ccmsetup. propriedade msi para passar parâmetros e propriedades de linha de comando adicionais para ccmsetup. exe. Inclua outros parâmetros e propriedades dentro das aspas ("). Use essa propriedade ao inicializar o cliente Configuration Manager com o método de instalação do MDM do Intune.

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

Dica

Microsoft Intune limita a linha de comando a 1024 caracteres.

Client.msi propriedades

As propriedades a seguir podem modificar o comportamento de instalação do client.msi, que ccmsetup.exe instala.

AADCLIENTAPPID

Especifica o identificador do aplicativo cliente Microsoft Entra. Você cria ou importa o aplicativo cliente ao configurar os serviços do Azure para Gerenciamento de Nuvem. Um administrador do Azure pode obter o valor dessa propriedade do portal do Azure. Para obter mais informações, confira Obter ID do aplicativo. Para a AADCLIENTAPPID propriedade, essa ID do aplicativo é para o tipo de aplicativo nativo .

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

AADRESOURCEURI

Especifica o identificador de aplicativo do servidor Microsoft Entra. Você cria ou importa o aplicativo de servidor ao configurar os serviços do Azure para Gerenciamento de Nuvem. Quando você cria o aplicativo de servidor, na janela Criar Aplicativo do Servidor, essa propriedade é o URI da ID do Aplicativo.

Um administrador do Azure pode obter o valor dessa propriedade do portal do Azure. Em Microsoft Entra ID, localize o aplicativo do servidor em Registros de aplicativo. Procure aplicativo Web do tipo de aplicativo/API. Abra o aplicativo, selecione Configurações e selecione Propriedades. Use o valor do URI da ID do aplicativo para essa AADRESOURCEURI propriedade de instalação do cliente.

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

AADTENANTID

Especifica o Microsoft Entra identificador de locatário. Configuration Manager links para esse locatário ao configurar os serviços do Azure para Gerenciamento de Nuvem. Para obter o valor dessa propriedade, use as seguintes etapas:

  • Em um dispositivo que executa Windows 10 ou posterior e é ingressado no mesmo locatário Microsoft Entra, abra um prompt de comando.

  • Execute o seguinte comando: dsregcmd.exe /status

  • Na seção Estado do Dispositivo, localize o valor TenantId . Por exemplo, TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49a

    Observação

    Um administrador do Azure também pode obter esse valor no portal do Azure. Para obter mais informações, confira Obter ID do locatário.

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

CCMADMINS

Especifica uma ou mais contas de usuário ou grupos do Windows a serem acessados às configurações e políticas do cliente. Essa propriedade é útil quando você não tem credenciais administrativas locais no computador cliente. Especifique uma lista de contas separadas por ponto e vírgula (;).

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

CCMALLOWSILENTREBOOT

Se necessário, permita que o computador reinicie silenciosamente após a instalação do cliente.

Importante

Quando você usa essa propriedade, o computador é reiniciado sem aviso. Esse comportamento ocorre mesmo se um usuário estiver conectado ao Windows.

Exemplo: CCMSetup.exe CCMALLOWSILENTREBOOT

CCMALWAYSINF

Para especificar que o cliente é sempre baseado na Internet e nunca se conecta à intranet, defina esse valor de propriedade como 1. O tipo de conexão do cliente exibe a Internet Always.

Use essa propriedade com CCMHOSTNAME para especificar o FQDN do ponto de gerenciamento baseado na Internet. Use-o também com o parâmetro CCMSetup UsePKICert e a propriedade SMSSITECODE .

Para obter mais informações sobre o gerenciamento de clientes baseado na Internet, consulte Considerações sobre comunicações de cliente da Internet ou de uma floresta não confiável.

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

CCMCERTISSUERS

Use essa propriedade para especificar a lista de emissores de certificado. Esta lista inclui informações de certificado para as autoridades de certificação raiz confiáveis (AC) que o site Configuration Manager confia.

Esse valor é uma correspondência sensível a casos para atributos de assunto que estão no certificado de AC raiz. Separar atributos por uma vírgula (,) ou um ponto e vírgula (;). Especifique mais de um certificado de AC raiz usando uma barra de separador (|).

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

Dica

Use o valor do atributo CertificateIssuers no arquivo mobileclient.tcf para o site. Esse arquivo está na \bin\<platform> subpasta do Configuration Manager diretório de instalação no servidor do site.

Para obter mais informações sobre a lista de emissores de certificado e como os clientes a usam durante o processo de seleção de certificados, consulte Planejamento para seleção de certificado de cliente PKI.

CCMCERTNAMECHECK

A partir da versão 2207, essa propriedade pode ser usada para ignorar a verificação do nome da entidade para o certificado. CCMCERTNAMECHECK=0 ignora a verificação do nome da entidade do certificado.

CCMCERTSEL

Se o cliente tiver mais de um certificado para comunicação HTTPS, essa propriedade especificará os critérios para que ele selecione um certificado de autenticação de cliente válido.

Use as seguintes palavras-chave para pesquisar o nome do assunto do certificado ou o nome alternativo do assunto:

  • Subject: localizar uma correspondência exata
  • SubjectStr: encontrar uma correspondência parcial

Exemplos:

  • CCMCERTSEL="Subject:computer1.contoso.com": pesquise um certificado com uma correspondência exata com o nome computer1.contoso.com do computador no Nome da Entidade ou no Nome Alternativo do Assunto.

  • CCMCERTSEL="SubjectStr:contoso.com": pesquise um certificado que contenha contoso.com no Nome do Assunto ou no Nome Alternativo do Assunto.

Use o SubjectAttr palavra-chave para pesquisar os atributos OID (Identificador de Objeto) ou nome distinto no Nome do Assunto ou Nome Alternativo do Assunto.

Exemplos:

  • CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": pesquise o atributo de unidade organizacional expresso como um identificador de objeto e chamado Computers.

  • CCMCERTSEL="SubjectAttr:OU = Computers": pesquise o atributo de unidade organizacional expresso como um nome distinto e chamado Computers.

Importante

Se você usar o Nome do Assunto, o Subject palavra-chave será sensível a maiúsculas de maiúsculas de minúsculas e o SubjectStr palavra-chave será insensibilidade de maiúsculas de minúsculas.

Se você usar o Nome Alternativo do Assunto, as Subject palavras-chave e as SubjectStr palavras-chave serão insensíveis a casos.

Para obter a lista completa de atributos que você pode usar para seleção de certificados, consulte Valores de atributo com suporte para critérios de seleção de certificado PKI.

Se mais de um certificado corresponder à pesquisa e você definir CCMFIRSTCERT como 1, o instalador do cliente selecionará o certificado com o período de validade mais longo.

CCMCERTSTORE

Se o instalador do cliente não conseguir localizar um certificado válido no repositório de certificados pessoal padrão para o computador, use essa propriedade para especificar um nome de repositório de certificados alternativo.

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

CCMDEBUGLOGGING

Essa propriedade habilita o registro em log de depuração quando o cliente é instalado. Essa propriedade faz com que o cliente registre informações de baixo nível para solução de problemas. Evite usar essa propriedade em sites de produção. Pode ocorrer registro em log excessivo, o que pode dificultar a localização de informações relevantes nos arquivos de log. Habilite CCMENABLELOGGINGtambém .

Valores com suporte:

  • 0: Desative o registro em log de depuração (padrão)
  • 1: ativar o registro em log de depuração

Exemplo: CCMSetup.exe CCMDEBUGLOGGING=1

Para obter mais informações, consulte Sobre arquivos de log.

CCMENABLELOGGING

Configuration Manager habilita o registro em log por padrão.

Valores com suporte:

  • TRUE: ativar o log (padrão)
  • FALSE: desativar o log

Exemplo: CCMSetup.exe CCMENABLELOGGING=TRUE

Para obter mais informações, consulte Sobre arquivos de log.

CCMEVALINTERVAL

A frequência em minutos em que a ferramenta de avaliação de integridade do cliente (ccmeval.exe) é executada. Especifique um valor inteiro de 1 para 1440. Por padrão, o ccmeval é executado uma vez por dia (1440 minutos).

Exemplo: CCMSetup.exe CCMEVALINTERVAL=1440

Para obter mais informações sobre a avaliação da integridade do cliente, consulte Monitorar clientes.

CCMEVALHOUR

A hora durante o dia em que a ferramenta de avaliação de integridade do cliente (ccmeval.exe) é executada. Especifique um valor inteiro de 0 (meia-noite) até 23 (23h). Por padrão, o ccmeval é executado à meia-noite.

Para obter mais informações sobre a avaliação da integridade do cliente, consulte Monitorar clientes.

CCMFIRSTCERT

Se você definir essa propriedade como 1, o cliente selecionará o certificado PKI com o período de validade mais longo.

Exemplo: CCMSetup.exe /UsePKICert CCMFIRSTCERT=1

CCMHOSTNAME

Se o cliente for gerenciado pela Internet, essa propriedade especificará o FQDN do ponto de gerenciamento baseado na Internet.

Não especifique essa opção com a propriedade de instalação de SMSSITECODE=AUTO. Atribua diretamente clientes baseados na Internet a um site baseado na Internet.

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

Essa propriedade pode especificar o endereço de um CMG (gateway de gerenciamento de nuvem). Para obter o valor dessa propriedade, use as seguintes etapas:

  • Crie um CMG. Para obter mais informações, consulte Configurar um CMG.

  • Em um cliente ativo, abra um prompt de comando Windows PowerShell como administrador.

  • Execute o seguinte comando:

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

  • Use o valor retornado como está com a CCMHOSTNAME propriedade.

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

Importante

Quando você especificar o endereço de um CMG para a CCMHOSTNAME propriedade, não adicione um prefixo como https://. Use apenas esse prefixo com a /mp URL de um CMG.

CCMHTTPPORT

Especifica a porta para o cliente usar quando ele se comunica por HTTP para servidores do sistema de sites. Por padrão, esse valor é 80.

Exemplo: CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORT

Especifica a porta para o cliente usar quando ele se comunica por HTTPS para servidores do sistema de sites. Por padrão, esse valor é 443.

Exemplo: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

Use essa propriedade para definir a pasta para instalar os arquivos do cliente Configuration Manager. Por padrão, ele usa %WinDir%\CCM.

Dica

Independentemente de onde você instale os arquivos do cliente, ele sempre instala o arquivo ccmcore.dll na %WinDir%\System32 pasta. Em um sistema operacional de 64 bits, ele instala uma cópia de ccmcore.dll na %WinDir%\SysWOW64 pasta. Esse arquivo dá suporte a aplicativos de 32 bits que usam a versão de 32 bits das APIs do cliente do SDK Configuration Manager.

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

CCMLOGLEVEL

Use essa propriedade para especificar o nível de detalhes para gravar em Configuration Manager arquivos de log.

Valores com suporte:

  • 0:Verbose
  • 1:Padrão
  • 2: avisos e erros
  • 3: somente erros

Exemplo: CCMSetup.exe CCMLOGLEVEL=0

Para obter mais informações, consulte Sobre arquivos de log.

CCMLOGMAXHISTORY

Quando um arquivo de log Configuration Manager atinge o tamanho máximo, o cliente o renomeia como um backup e cria um novo arquivo de log. Essa propriedade especifica quantas versões anteriores do arquivo de log deve ser mantida. O valor padrão é 1. Se você definir o valor como 0, o cliente não manterá nenhum histórico de arquivos de log.

Exemplo: CCMSetup.exe CCMLOGMAXHISTORY=5

Para obter mais informações, consulte Sobre arquivos de log.

CCMLOGMAXSIZE

Essa propriedade especifica o tamanho máximo do arquivo de log em bytes. Quando um log cresce para o tamanho especificado, o cliente o renomeia como um arquivo de histórico e cria um novo. O tamanho padrão é de 250.000 bytes e o tamanho mínimo é de 10.000 bytes.

Exemplo: CCMSetup.exe CCMLOGMAXSIZE=300000 (300.000 bytes)

DISABLESITEOPT

Defina essa propriedade para impedir que TRUE os administradores alterem o site atribuído no painel de controle Configuration Manager.

Exemplo: CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

Se definida como TRUE, essa propriedade desabilita a capacidade dos usuários administrativos de alterar as configurações da pasta de cache do cliente no painel de controle Configuration Manager.

Exemplo: CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIX

Especifique um domínio DNS para os clientes localizarem pontos de gerenciamento publicados no DNS. Quando o cliente localiza um ponto de gerenciamento, ele informa ao cliente sobre outros pontos de gerenciamento na hierarquia. Esse comportamento significa que o ponto de gerenciamento que o cliente encontra do DNS pode ser qualquer um na hierarquia.

Observação

Você não precisará especificar essa propriedade se o cliente estiver no mesmo domínio que um ponto de gerenciamento publicado. Nesse caso, o domínio do cliente é usado automaticamente para pesquisar pontos de gerenciamento do DNS.

Para obter mais informações sobre a publicação de DNS como um método de local de serviço para clientes Configuration Manager, consulte Local do serviço e como os clientes determinam seu ponto de gerenciamento atribuído.

Observação

Por padrão, Configuration Manager não habilita a publicação DNS.

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

FSP

Especifique o ponto de status de fallback que recebe e processa mensagens de estado enviadas por clientes Configuration Manager.

Para obter mais informações, consulte Determinar se você precisa de um ponto de status de fallback.

Exemplo: CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

Se você definir essa propriedade como TRUE, o instalador do cliente não marcar a versão mínima necessária da Virtualização de Aplicativo da Microsoft (App-V).

Importante

Se você instalar o Configuration Manager cliente sem instalar o App-V, não poderá implantar aplicativos virtuais.

Exemplo: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

MANAGEDINSTALLER

Se você definir essa propriedade para 1 ccmsetup.exe e client.msi serão definidos como instaladores gerenciados. Para obter mais informações, confira Permitir automaticamente aplicativos implantados por um instalador gerenciado com Windows Defender Controle de Aplicativo.

Exemplo: CCMSetup.exe MANAGEDINSTALLER=1

NOTIFYONLY

Quando você habilita essa propriedade, o cliente relata status, mas não corrige os problemas encontrados.

Exemplo: CCMSetup.exe NOTIFYONLY=TRUE

Para obter mais informações, consulte Como configurar o status do cliente.

PROVISIONTS

Use essa propriedade para iniciar uma sequência de tarefas em um cliente depois que ele se registrar com êxito no site.

Observação

Se a sequência de tarefas instalar atualizações de software ou aplicativos, os clientes precisarão de um certificado de autenticação de cliente válido. A autenticação de token por si só não funciona.

Por exemplo, você provisiona um novo dispositivo Windows com o Windows Autopilot, registra-o automaticamente para Microsoft Intune e instala o cliente Configuration Manager para cogerenciamento. Se você especificar essa nova opção, o cliente recém-provisionado executará uma sequência de tarefas. Esse processo oferece flexibilidade adicional para instalar aplicativos e atualizações de software ou configurar configurações.

Use o seguinte processo:

  1. Crie uma sequência de tarefas de implantação fora do sistema operacional para instalar aplicativos, instalar atualizações de software e configurar configurações.

  2. Implante essa sequência de tarefas na nova coleção interna, Todos os Dispositivos de Provisionamento. Observe a ID de implantação da sequência de tarefas, por exemplo PRI20001.

    Dica

    A finalidade da implantação pode estar disponível ou necessária. Como você especifica a ID de implantação como o valor da propriedade, a finalidade não importa.

  3. Instale o cliente Configuration Manager em um dispositivo usando ccmsetup.msie inclua a seguinte propriedade: PROVISIONTS=PRI20001. Defina o valor dessa propriedade como a ID de implantação da sequência de tarefas.

    • Se você estiver instalando o cliente do Intune durante o registro de cogerenciamento, consulte Como preparar dispositivos baseados na Internet para cogerenciamento.

      Observação

      Esse método pode ter pré-requisitos adicionais. Por exemplo, registrar o site para Microsoft Entra ID ou criar um gateway de gerenciamento de nuvem habilitado para conteúdo.

      Independentemente do método, use apenas essa propriedade com ccmsetup.msi.

Depois que o cliente instala e se registra corretamente no site, ele inicia a sequência de tarefas referenciada. Se o registro do cliente falhar, a sequência de tarefas não será iniciada.

Observação

A sequência de tarefas iniciada por PROVISIONTS usa as Configurações padrão do cliente. Essa sequência de tarefas começa imediatamente após o registro do cliente, portanto, não fará parte de nenhuma coleção para a qual você implantou as configurações personalizadas do cliente. O cliente não processa nem aplica configurações de cliente personalizadas antes da execução dessa sequência de tarefas.

Para que a sequência de tarefas funcione corretamente, talvez seja necessário alterar determinadas configurações nas Configurações padrão do cliente. Por exemplo:

  • Serviços de Nuvem grupo: permitir que os clientes usem um gateway de gerenciamento de nuvem e permitir acesso ao ponto de distribuição de nuvem
  • Grupo do Agente de Computador : política de execução do PowerShell

Se os dispositivos não precisarem dessas configurações de cliente após a conclusão da sequência de tarefas, implante novas configurações de cliente personalizadas para reverter as configurações padrão.

Para obter mais informações, consulte Sobre as configurações do cliente.

RESETKEYINFORMATION

Se um cliente tiver a chave raiz confiável Configuration Manager errada, ele não poderá contatar um ponto de gerenciamento confiável para receber a nova chave raiz confiável. Use essa propriedade para remover a chave raiz confiável antiga. Essa situação pode ocorrer quando você move um cliente de uma hierarquia de site para outra. Essa propriedade se aplica a clientes que usam comunicação de cliente HTTP e HTTPS. Para obter mais informações, confira Planejamento para a chave raiz confiável.

Exemplo: CCMSetup.exe RESETKEYINFORMATION=TRUE

SITEREASSIGN

Habilita a reatribuição automática do site para atualizações de cliente quando usada com SMSSITECODE=AUTO.

Exemplo: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE

SMSCACHEDIR

Especifica o local da pasta de cache do cliente no computador cliente. Por padrão, o local do cache é %WinDir%\ccmcache.

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

Use essa propriedade com a SMSCACHEFLAGS propriedade para controlar o local da pasta de cache do cliente. Por exemplo, para instalar a pasta de cache do cliente na maior unidade de disco do cliente disponível: CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE

SMSCACHEFLAGS

Use essa propriedade para especificar mais detalhes de instalação para a pasta cache do cliente. Você pode usar SMSCACHEFLAGS propriedades individualmente ou em combinação separada por ponto e vírgula (;).

Se você não incluir esta propriedade:

  • O cliente instala a pasta de cache de acordo com a SMSCACHEDIR propriedade
  • A pasta não é compactada
  • O cliente usa a SMSCACHESIZE propriedade como o limite de tamanho no MB do cache

Quando você atualiza um cliente existente, o instalador do cliente ignora essa propriedade.

Valores da SMSCACHEFLAGS propriedade

  • PERCENTDISKSPACE: defina o tamanho do cache como uma porcentagem do espaço total do disco. Se você especificar essa propriedade, também definirá SMSCACHESIZE como um valor percentual.

  • PERCENTFREEDISKSPACE: defina o tamanho do cache como uma porcentagem do espaço livre em disco. Se você especificar essa propriedade, também defina SMSCACHESIZE como um valor percentual. Por exemplo, o disco tem 10 MB gratuitos e você especifica SMSCACHESIZE=50. O instalador do cliente define o tamanho do cache como 5 MB. Você não pode usar essa propriedade com a PERCENTDISKSPACE propriedade.

  • MAXDRIVE: instale o cache no maior disco disponível. Se você especificar um caminho com a SMSCACHEDIR propriedade, o instalador do cliente ignorará esse valor.

  • MAXDRIVESPACE: instale o cache na unidade de disco com o espaço mais livre. Se você especificar um caminho com a SMSCACHEDIR propriedade, o instalador do cliente ignorará esse valor.

  • NTFSONLY: instale apenas o cache em uma unidade de disco formatada pelo NTFS. Se você especificar um caminho com a SMSCACHEDIR propriedade, o instalador do cliente ignorará esse valor.

  • COMPRESS: armazene o cache em um formulário compactado.

  • FAILIFNOSPACE: se não houver espaço suficiente para instalar o cache, remova o Configuration Manager cliente.

Exemplo: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

Importante

As configurações do cliente estão disponíveis para especificar o tamanho da pasta de cache do cliente. A adição dessas configurações de cliente substitui efetivamente o uso de SMSCACHESIZE como uma propriedade client.msi para especificar o tamanho do cache do cliente. Para obter mais informações, confira as configurações do cliente para o tamanho do cache.

Quando você atualiza um cliente existente, o instalador do cliente ignora essa configuração. O cliente também ignora o tamanho do cache quando baixa atualizações de software.

Exemplo: CCMSetup.exe SMSCACHESIZE=100

Observação

Se você reinstalar um cliente, não poderá usar SMSCACHESIZE ou SMSCACHEFLAGS definir o tamanho do cache como menor do que era anteriormente. O tamanho anterior é o valor mínimo.

SMSCONFIGSOURCE

Use essa propriedade para especificar o local e ordenar que o instalador do cliente verifique as configurações. É uma cadeia de caracteres de um ou mais caracteres, cada um definindo uma fonte de configuração específica:

  • R: verifique se há configurações no registro.

    Para obter mais informações, consulte Provisionar propriedades de instalação do cliente.

  • P: Verifique se há configurações nas propriedades de instalação da linha de comando.

  • M: verifique se há configurações existentes ao atualizar um cliente mais antigo.

  • U: atualize o cliente instalado para uma versão mais recente e use o código do site atribuído.

Por padrão, o instalador do cliente usa PU. Ele primeiro verifica as propriedades de instalação (P) e, em seguida, as configurações existentes (U).

Exemplo: CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMP

Especifica um ponto de gerenciamento inicial para o Configuration Manager cliente a ser usado.

Importante

Se o ponto de gerenciamento aceitar apenas conexões de cliente por HTTPS, prefixe o nome do ponto de gerenciamento com https://.

Exemplos:

  • CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSMPLIST

Especifica uma lista de pontos de gerenciamento para o Configuration Manager cliente a ser usado. Use um ponto e vírgula (;) como delimitador ao especificar vários pontos de gerenciamento.

Importante

Se o ponto de gerenciamento aceitar apenas conexões de cliente por HTTPS, prefixe o nome do ponto de gerenciamento com https://.

Exemplos:

  • 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

Se o cliente não conseguir obter o Configuration Manager chave raiz confiável de Active Directory Domain Services, use essa propriedade para especificar a chave. Essa propriedade se aplica a clientes que usam comunicação HTTP e HTTPS. Para obter mais informações, confira Planejamento para a chave raiz confiável.

Exemplo: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

Dica

Obtenha o valor da chave raiz confiável do site no arquivo mobileclient.tcf no servidor do site. Para obter mais informações, consulte Pré-provisionar um cliente com a chave raiz confiável usando um arquivo.

SMSROOTKEYPATH

Use essa propriedade para reinstalar o Configuration Manager chave raiz confiável. Ele especifica o caminho completo e o nome de um arquivo que contém a chave raiz confiável. Essa propriedade se aplica a clientes que usam comunicação de cliente HTTP e HTTPS. Para obter mais informações, confira Planejamento para a chave raiz confiável.

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

SMSSIGNCERT

Especifica o caminho completo e o nome do certificado autoassinado exportado no servidor do site. O servidor do site armazena esse certificado no repositório de certificados SMS . Ele tem o nome da entidade Site Server e o nome amigável Certificado de Assinatura do Servidor do Site.

Exporte o certificado sem a chave privada, armazene o arquivo com segurança e acesse-o somente de um canal protegido.

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

SMSSITECODE

Essa propriedade especifica um site Configuration Manager ao qual você atribui o cliente. Esse valor pode ser um código de site de três caracteres ou a palavra AUTO. Se você especificar AUTOou não especificar essa propriedade, o cliente tentará determinar sua atribuição de site de Active Directory Domain Services ou de um ponto de gerenciamento especificado. Para habilitar AUTO as atualizações do cliente, defina TAMBÉM SITEREASSIGN=TRUE.

Observação

Se você também especificar um ponto de gerenciamento baseado na Internet com a CCMHOSTNAME propriedade, não use AUTO com SMSSITECODE. Atribua diretamente o cliente ao seu site especificando o código do site.

Exemplo: CCMSetup.exe SMSSITECODE=XZY

UPGRADETOLATEST

Essa propriedade força o CCMSetup a enviar uma solicitação de local para o ponto de gerenciamento para obter a versão mais recente do Configuration Manager fonte de instalação do cliente. Há vários cenários em que essa propriedade é especialmente útil:

  • Clientes de pré-produção. Um cliente recém-instalado usa a linha de base de produção porque não pode avaliar a coleção de pré-produção até que o cliente seja instalado. Nesse cenário, depois que o cliente for instalado e avaliar a política, ele será atualizado posteriormente para a versão do cliente de pré-produção. Use essa propriedade para que o dispositivo instale imediatamente a versão mais recente do cliente.

    Esse cenário também inclui ao usar o Autopilot no cogerenciamento. Use essa propriedade para garantir que o dispositivo Autopilot recém-provisionado use a versão do cliente de pré-produção imediatamente.

  • Puxar pontos de distribuição. Permitir que os pontos de distribuição de pull instalem a versão mais recente do cliente, mesmo que não esteja na coleção de pré-produção. Essa ação garante que a versão do cliente no ponto de distribuição de pull seja a mesma que os binários do ponto de distribuição. Se essas versões não forem as mesmas, elas poderão causar problemas.

Valores de atributo para critérios de seleção de certificado

Configuration Manager dá suporte aos seguintes valores de atributo para os critérios de seleção de certificado PKI:

Atributo OID Atributo Name distinto Definição de atributo
0.9.2342.19200300.100.1.25 DC Componente de domínio
1.2.840.113549.1.9.1 Email ou email Endereço de email
2.5.4.3 CN Nome comum
2.5.4.4 SN Nome da entidade
2.5.4.5 SERIALNUMBER Número de série
2.5.4.6 C Código do país
2.5.4.7 L Localidade
2.5.4.8 S ou ST Nome do estado ou da província
2.5.4.9 RUA Endereço
2.5.4.10 O Nome da organização
2.5.4.11 OU Unidade organizacional
2.5.4.12 T ou Título Título
2.5.4.42 G ou GN ou GivenName Nome fornecido
2.5.4.43 I ou Iniciais Initials
2.5.29.17 (sem valor) Nome alternativo do assunto

Instalação push do cliente

Se você usar o método de instalação por push do cliente, use as seguintes opções na guia Cliente das Propriedades de Instalação de Push do Cliente no console Configuration Manager: