Sobre os parâmetros e propriedades de instalação do cliente no Gerenciador de Configurações

Aplica-se a: Gerenciador de Configurações (branch atual)

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

Sobre CCMSetup.exe

O comando CCMSetup.exe baixa os 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 do Gerenciador de Configurações

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úsculos. Você especifica o valor de um parâmetro quando necessário usando dois-pontos (:) imediatamente seguidos pelo valor. Para obter mais informações, consulte CCMSetup.exe parâmetros de linha de comando.

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

CCMSetup.exe e os arquivos de suporte estão no servidor do site na pasta Cliente da pasta de instalação do Gerenciador de Configurações. O Gerenciador de Configurações compartilha essa pasta com 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 o seguinte:

• 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 deverá ser interrompida se uma versão do cliente já existir no computador.

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

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

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

CCMSetup.exe parâmetros de linha de comando

/?

Mostra os 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 aceita valores. Quando você permite a comunicação do cliente em uma rede limitada para ccmsetup, ela baixa o conteúdo, registra-se no site e baixa a política inicial. Qualquer comunicação adicional com o cliente segue a configuração da configuração do cliente 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 será ou não atualizado automaticamente quando você habilitar a atualização automática do cliente.

Valores com suporte:

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

Por exemplo:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

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

/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 este 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 \bin\<platform> arquivo mobileclienttemplate.tcf na pasta no diretório de instalação do Gerenciador de Configurações no servidor do site. Este arquivo contém 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.

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

/downloadtimeout

Se o CCMSetup não conseguir 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 interrompe a tentativa de baixar os arquivos de instalação. O valor padrão é 1440 minutos (um dia).

Use o /retry parâmetro para especificar o intervalo entre as 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.

/forceinstall

Especifique que CCMSetup.exe desinstala qualquer cliente existente e instala um novo cliente.

/forcereboot

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

Exemplo: CCMSetup.exe /forcereboot

/logon

Se qualquer 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 a ser usado pelos clientes 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 se os computadores não conseguirem 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 do ccmsetup se você usar os /mp parâmetros and /source .

Os computadores baixam os arquivos por meio de uma conexão HTTP ou HTTPS, dependendo da configuração da função do sistema de sites para conexões de cliente. O download também poderá usar a limitação de BITS se você configurá-lo. Se você configurar todos os pontos de distribuição e pontos de gerenciamento apenas 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 conseguir 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írgulas.

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 à Entidade do certificado PKI do ponto de gerenciamento ou ao Nome Alternativo da Entidade. Embora o Gerenciador de Configurações 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 do Windows PowerShell como administrador.

• Execute o seguinte comando:

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

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

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

/NoCRLCheck

Especifica que um cliente não deve marcar a CRL (lista de certificados revogados) quando se comunica por HTTPS com um certificado PKI. Quando você não especifica esse parâmetro, o cliente verifica a CRL antes de estabelecer uma conexão HTTPS. Para obter mais informações sobre a verificação de CRL do cliente, consulte Planejando a 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 é feito por padrão. Quando o CCMSetup é executado como um serviço, ele é executado no contexto da conta 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 usada 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:

• /mp
• CCMHOSTNAME
• SMSSITECODE
• SMSMP

A linha de comando de exemplo a seguir inclui os outros parâmetros e propriedades de configuraçã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

/retry

Se CCMSetup.exe não conseguir baixar os 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 /downloadtimeout limite especificado no 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.

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 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 mensagem do servidor). Para usar /source, a conta de usuário do Windows para instalação do cliente precisa de permissões de leitura no 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 do ccmsetup se você usar os /mp parâmetros and /source .

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

/uninstall

Use esse parâmetro para desinstalar o cliente do Gerenciador de Configurações. Para obter mais informações, consulte Desinstalar o cliente.

Exemplo: ccmsetup.exe /uninstall

/UsePKICert

Especifique esse parâmetro para que o cliente use 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 filtrará todos os pontos de gerenciamento HTTPS, incluindo CMG (gateways de gerenciamento de nuvem). O cliente usa uma conexão HTTP com um certificado autoassinado.

Exemplo: CCMSetup.exe /UsePKICert

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

/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, reveja %WinDir%\ccmsetup\Logs\ccmsetup.log no cliente o contexto e detalhes adicionais sobre os códigos de retorno.

Ccmsetup.msi propriedades

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

CCMSETUPCMD

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

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

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 do 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 no portal do Azure. Para obter mais informações, consulte obter ID do aplicativo. Para a AADCLIENTAPPID propriedade, essa ID de aplicativo é para o tipo de aplicativo Nativo .

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

AADRESOURCEURI

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

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

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

AADTENANTID

Especifica o identificador de locatário do Microsoft Entra. O Gerenciador de Configurações se conecta a esse locatário quando você configura os serviços do Azure para Gerenciamento de Nuvem. Para obter o valor dessa propriedade, use as seguintes etapas:

• Em um dispositivo que executa o Windows 10 ou posterior e ingressou no mesmo locatário do 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 : aaaabbbb-0000-cccc-1111-dddd2222eeee

  Observação

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

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

CCMADMINS

Especifica uma ou mais contas de usuário ou grupos do Windows que devem receber acesso às configurações e políticas do cliente. Esta 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.

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 Always Internet.

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 esta propriedade para especificar a lista de emissores de certificados. Esta lista inclui informações de certificado para as autoridades de certificação (AC) raiz confiáveis em que o site do Gerenciador de Configurações confia.

Esse valor diferencia maiúsculas de minúsculas para atributos de assunto que estão no certificado de autoridade de certificação raiz. Separe os atributos por vírgula (,) ou ponto e vírgula (;). Especifique mais de um certificado de autoridade de certificação raiz usando uma barra separadora (|).

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

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

CCMCERTNAMECHECK

A partir da versão 2207, esta propriedade pode ser usada para ignorar a verificação do nome da entidade do 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 certificado: Nome da Entidade ou Nome Alternativo da Entidade:

• Subject: Encontre 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 da Entidade.

• CCMCERTSEL="SubjectStr:contoso.com": Procure um certificado que contenha contoso.com no Nome da Entidade ou o Nome Alternativo da Entidade.

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

Exemplos:

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

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

Para obter a lista completa de atributos que você pode usar para seleção de certificados, consulte Valores de atributos com suporte para critérios de seleção de certificados 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 armazenamento de certificados Particular padrão do 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 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 um log excessivo, o que pode dificultar a localização de informações relevantes nos arquivos de log. Habilite CCMENABLELOGGINGtambém o .

Valores com suporte:

• 0: Desativar o log de depuração (padrão)
• 1: Ativar o log de depuração

Exemplo: CCMSetup.exe CCMDEBUGLOGGING=1

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

CCMENABLELOGGING

O Gerenciador de Configurações habilita o registro em log por padrão.

Valores com suporte:

• TRUE: Ativar registro em log (padrão)
• FALSE: Desativar o registro em log

Exemplo: CCMSetup.exe CCMENABLELOGGING=TRUE

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

CCMEVALINTERVAL

A frequência em minutos com que a (ccmeval.exe) ferramenta de avaliação de integridade do cliente é executada. Especifique um valor inteiro de 1 até 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 (ccmeval.exe) ferramenta de avaliação de integridade do cliente é executada. Especifique um valor inteiro de 0 (meia-noite) a 23 (23:00). 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. Atribuir diretamente clientes da Internet a um site baseado na Internet.

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

Esta 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 do 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 no estado em que se encontra com a CCMHOSTNAME propriedade.

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

CCMHTTPPORT

Especifica a porta a ser usada pelo cliente quando ele se comunica por HTTP com os servidores do sistema de sites. Por padrão, esse valor é 80.

Exemplo: CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORT

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

Exemplo: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

Use esta propriedade para definir a pasta para instalar os arquivos de cliente do Gerenciador de Configurações. Por padrão, ele usa %WinDir%\CCM.

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

CCMLOGLEVEL

Use esta propriedade para especificar o nível de detalhe a ser gravado nos arquivos de log do Gerenciador de Configurações.

Valores com suporte:

• 0: Detalhado
• 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 do Gerenciador de Configurações atinge o tamanho máximo, o cliente o renomeia como backup e cria um novo arquivo de log. Esta propriedade especifica quantas versões anteriores do arquivo de log devem ser mantidas. O valor padrão é 1. Se você definir o valor como 0, o cliente não manterá nenhum histórico do arquivo de log.

Exemplo: CCMSetup.exe CCMLOGMAXHISTORY=5

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

CCMLOGMAXSIZE

Esta propriedade especifica o tamanho máximo do arquivo de log em bytes. Quando um log atinge o tamanho especificado, o cliente o renomeia como 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 esta propriedade como TRUE para impedir que os administradores alterem o site atribuído no painel de controle do Gerenciador de Configurações.

Exemplo: CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

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

Exemplo: CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIX

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

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

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 do Gerenciador de Configurações.

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 do Microsoft Application Virtualization (App-V).

Exemplo: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

MANAGEDINSTALLER

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

Exemplo: CCMSetup.exe MANAGEDINSTALLER=1

NOTIFYONLY

Quando você habilita essa propriedade, o cliente relata o 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 esta propriedade para iniciar uma sequência de tarefas em um cliente depois que ele for registrado com êxito no site.

Por exemplo, você provisiona um novo dispositivo Windows com o Windows Autopilot, registra-o automaticamente no Microsoft Intune e, em seguida, instala o cliente do Gerenciador de Configurações 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 definir configurações.

Use o seguinte processo:

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

2. Implante essa sequência de tarefas na nova coleção interna, Todos os Dispositivos de Provisionamento. Anote 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 Gerenciador de Configurações em um dispositivo usando occmsetup.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 no Microsoft Entra ID ou criar um gateway de gerenciamento de nuvem habilitado para conteúdo.

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

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

RESETKEYINFORMATION

Se um cliente tiver a chave de raiz confiável errada do Gerenciador de Configurações, ele não poderá entrar em contato com um ponto de gerenciamento confiável para receber a nova chave de raiz confiável. Use essa propriedade para remover a antiga chave de raiz confiável. 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, consulte Planejamento da chave raiz confiável.

Exemplo: CCMSetup.exe RESETKEYINFORMATION=TRUE

SITEREASSIGN

Habilita a reatribuição automática de site para atualizações de cliente quando usado 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 a localização da pasta de cache do cliente. Por exemplo, para instalar a pasta cache do cliente na maior unidade de disco cliente disponível: CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE

SMSCACHEFLAGS

Use esta propriedade para especificar detalhes de instalação adicionais para a pasta de cache do cliente. Você pode usar SMSCACHEFLAGS propriedades individualmente ou em combinação, separadas 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 está compactada
• O cliente usa a SMSCACHESIZE propriedade como o limite de tamanho em 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 em disco. Se você especificar essa propriedade, também defini-la SMSCACHESIZE como um valor percentual.

• PERCENTFREEDISKSPACE: Defina o tamanho do cache como uma porcentagem do espaço livre em disco. Se você especificar esta propriedade, também definir SMSCACHESIZE como um valor percentual. Por exemplo, o disco tem 10 MB livres e você especifica SMSCACHESIZE=50. O instalador do cliente define o tamanho do cache como 5 MB. Você não pode usar esta 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 mais espaço livre. Se você especificar um caminho com a SMSCACHEDIR propriedade, o instalador do cliente ignorará esse valor.

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

• COMPRESS: Armazene o cache em um formato compactado.

• FAILIFNOSPACE: se não houver espaço suficiente para instalar o cache, remova o cliente do Gerenciador de Configurações.

Exemplo: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

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

Exemplo: CCMSetup.exe SMSCACHESIZE=100

SMSCONFIGSOURCE

Use esta propriedade para especificar o local e a ordem em que o instalador cliente verificará as configurações. É uma sequência de um ou mais caracteres, cada um definindo uma fonte de configuração específica:

• R: verifique se há definições de configuração no registro.

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

• P: verifique as definições de configuração nas propriedades de instalação a partir da linha de comando.

• M: verifique as 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 de site atribuído.

Por padrão, o instalador do cliente usa PU. Primeiro, ele verifica as propriedades da 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 cliente do Gerenciador de Configurações usar.

Exemplos:

• CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSMPLIST

Especifica uma lista de pontos de gerenciamento para o cliente do Gerenciador de Configurações usar. Use um ponto e vírgula (;) como delimitador ao especificar vários pontos de gerenciamento.

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 puder obter a chave raiz confiável do Gerenciador de Configurações do Active Directory Domain Services, use esta propriedade para especificar a chave. Esta propriedade se aplica a clientes que usam comunicação HTTP e HTTPS. Para obter mais informações, consulte Planejamento da chave raiz confiável.

Exemplo: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

SMSROOTKEYPATH

Use esta propriedade para reinstalar a chave raiz confiável do Gerenciador de Configurações. 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, consulte Planejamento da 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 de Entidade Servidor do Site 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 seguro.

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

SMSSITECODE

Essa propriedade especifica um site do Gerenciador de Configurações 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 a partir do Active Directory Domain Services ou de um ponto de gerenciamento especificado. Para habilitar AUTO atualizações de cliente, defina também SITEREASSIGN=TRUE.

Exemplo: CCMSetup.exe SMSSITECODE=XZY

UPGRADETOLATEST

Essa propriedade força o CCMSetup a enviar uma solicitação de localização ao ponto de gerenciamento para obter a versão mais recente da fonte de instalação do cliente do Gerenciador de Configurações. 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 atualizará posteriormente para a versão do cliente de pré-produção. Use esta propriedade para que o dispositivo instale imediatamente a versão mais recente do cliente.

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

• Pontos de distribuição de pull. Permitir que os pontos de distribuição de pull instalem a versão mais recente do cliente, mesmo que ela 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, isso poderá causar problemas.

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

O Gerenciador de Configurações dá suporte aos seguintes valores de atributo para os critérios de seleção de certificado PKI:

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 da Instalação por Push do Cliente no console do Gerenciador de Configurações:

• Qualquer uma das propriedadesClient.msi

• O seguinte subconjunto de parâmetros de linha de comandoCCMSetup.exe é permitido para push do cliente:

  • /AllowMetered (iniciando na versão 2103)

  • /AlwaysExcludeUpgrade

  • /BITSPriority

  • /downloadtimeout

  • /ExcludeFeatures

  • /forcereboot

  • /logon

  • /skipprereq

  • /UsePKICert