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

Aplica-se a: Configuration Manager (ramo atual)

Utilize o comando CCMSetup.exe para instalar o cliente Gestor de Configuração. Se fornecer parâmetros de instalação do cliente na linha de comando, eles modificam o comportamento de instalação. Se fornecer propriedades de instalação do cliente na linha de comando, modificam a configuração inicial do agente cliente instalado.

Cerca de CCMSetup.exe

O comando CCMSetup.exe descarregamentos necessários para instalar o cliente a partir de um ponto de gestão ou de uma localização de origem. Estes ficheiros podem incluir:

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

• Pré-requisitos do cliente

• Atualizações e correções para o cliente Gestor de Configuração

CCMSetup.exe fornece parâmetros de linha de comando para personalizar a instalação. Os parâmetros são pré-fixados com um corte / () e são geralmente mais baixos. Especificar o valor de um parâmetro quando necessário usando um cólon : () imediatamente seguido pelo valor. Para obter mais informações, consulte CCMSetup.exe parâmetros da linha de comando.

Também pode fornecer propriedades na linha de comando CCMSetup.exe para modificar o comportamento de client.msi. Propriedades por convenção são maiússão. Você especifica um valor para um imóvel usando um sinal igual = () imediatamente seguido pelo valor. Para mais informações, consulte Client.msi propriedades.

CCMSetup.exe e os ficheiros de suporte estão no servidor do site na pasta cliente da pasta de instalação do Gestor de Configuração. O Gestor de Configuração partilha esta pasta para a rede sob a partilha do site. Por exemplo, \\SiteServer\SMS_ABC\Client.

Na linha de comandos, o comando CCMSetup.exe utiliza 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 gestão chamado SMSMP01 para solicitar uma lista de pontos de distribuição para descarregar os ficheiros de instalação do cliente.

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

• Indica ao client.msi que atribua o código de site S01 ao cliente.

• Indica ao client.msi que utilize o ponto de estado de contingência com o nome SMSFP01.

Se alargar o esquema de Diretório Ativo para Gestor de Configuração, o site publica muitas propriedades de instalação de clientes em Serviços de Domínio de Diretório Ativo. O cliente Do Gestor de Configuração lê automaticamente estas propriedades. Para mais informações, consulte sobre as propriedades de instalação do cliente publicadas nos Serviços de Domínio do Diretório Ativo

CCMSetup.exe parâmetros de linha de comando

/?

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

Exemplo: ccmsetup.exe /?

/PermitirMetered

A partir da versão 2006, utilize este parâmetro para controlar o comportamento do cliente numa rede de contadores. Este parâmetro não tem valores. Quando permite a comunicação do cliente numa rede de medição para o ccmsetup, descarrega o conteúdo, regista-se no site e descarrega a política inicial. Qualquer outra comunicação do cliente segue a configuração da definição do cliente a partir dessa apólice. Para mais informações, consulte sobre as definições do cliente.

Se reinstalar o cliente num dispositivo existente, utiliza a seguinte prioridade para determinar a sua configuração:

1. Política de clientes locais existente
2. A última linha de comando armazenada no registo Windows
3. Parâmetros na linha de comando ccmsetup

/SempreExcludeUpgrade

Este parâmetro especifica se um cliente irá ou não fazer uma atualização automática quando ativa a atualização automática do cliente.

Valores suportados:

• TRUE: O cliente não faz upgrade automaticamente
• FALSE: O cliente atualiza automaticamente (padrão)

Por exemplo:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

Para mais informações, consulte o cliente de interoperabilidade alargado.

/BITSPriority

Quando o dispositivo descarregar ficheiros de instalação do cliente sobre uma ligação HTTP, utilize este parâmetro para especificar a prioridade de descarregamento. Especificar um dos seguintes valores possíveis:

• FOREGROUND

• HIGH

• NORMAL (predefinição)

• LOW

Exemplo: ccmsetup.exe /BITSPriority:HIGH

/config

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

• Se o CCMSetup funciona como um serviço, coloque este ficheiro na pasta do sistema CCMSetup: %Windir%\Ccmsetup .

• Se especificar o parâmetro /noservice, coloque este ficheiro na mesma pasta que CCMSetup.exe.

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

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

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

/downloadtimeout

Se o CCMSetup não conseguir descarregar os ficheiros de instalação do cliente, este parâmetro especifica o tempo limite máximo em minutos. Após este intervalo, o CCMSetup para de tentar descarregar os ficheiros de instalação. O valor predefinido é de 1440 minutos (um dia).

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

Exemplo: ccmsetup.exe /downloadtimeout:100

/ExcluirFeaturas

Este parâmetro especifica que CCMSetup.exe não instala a função especificada.

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

/forceinstall

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

/forcereboot

Utilize este parâmetro para forçar o computador a reiniciar, se necessário, para completar a instalação. Se não especificar este parâmetro, o CCMSetup sai quando é necessário reiniciar. Em seguida, continua após o próximo reinício manual.

Exemplo: CCMSetup.exe /forcereboot

/logon

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

Exemplo: ccmsetup.exe /logon

/mp

Especifica um ponto de gestão de origem para os computadores se conectarem. Os computadores utilizam este ponto de gestão para encontrar o ponto de distribuição mais próximo dos ficheiros de instalação. Se não houver pontos de distribuição ou os computadores não conseguirem descarregar os ficheiros dos pontos de distribuição após quatro horas, descarregam os ficheiros do ponto de gestão especificado.

Para obter mais informações sobre como o ccmsetup descarrega conteúdo, consulte os grupos Boundary - instalação do cliente. Este artigo também inclui detalhes do comportamento do ccmsetup se utilizar parâmetros de /mp e /source.

Os computadores transferem os ficheiros através de uma ligação HTTP ou HTTPS, conforme a configuração da função do sistema de sites para ligações de cliente. O download também pode usar o estrangulamento BITS se o configurar. Se configurar todos os pontos de distribuição e pontos de gestão apenas para ligações ao cliente HTTPS, verifique se o computador cliente tem um certificado de cliente válido.

Pode utilizar o parâmetro da linha de comando /mp para especificar mais de um ponto de gestão. Se o computador não conseguir ligar-se ao primeiro, tenta o seguinte na lista especificada. Quando especificar vários pontos de gestão, separe os valores por pontos de sedição.

Se o cliente ligar a um ponto de gestão utilizando HTTPS, especifique o FQDN e não o nome do computador. O valor deve corresponder ao nome de objeto ou alternativa do certificado PKI do ponto de gestão. Embora o Gestor de Configuração suporte a utilização de um nome de computador no certificado para ligações na intranet, recomenda-se a utilização de um FQDN.

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

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

Este parâmetro também pode especificar o URL de um gateway de gestão de nuvem (CMG). Utilize este URL para instalar o cliente num dispositivo baseado na Internet. Para obter o valor deste parâmetro, utilize os seguintes passos:

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

• Num cliente ativo, abra um pedido 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
  

• Apecir o https:// prefixo para usar com o parâmetro /mp.

Exemplo para quando utilizar o URL de gateway de gestão de nuvem: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

/NoCRLCheck

Especifica que um cliente não deve verificar a lista de revogação do certificado (CRL) quando comunica através de HTTPS com um certificado PKI. Quando não especifica este parâmetro, o cliente verifica o CRL antes de estabelecer uma ligação HTTPS. Para obter mais informações sobre a verificação do cliente CRL, consulte Planeamento para revogação de certificadoS PKI.

Exemplo: CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

Este parâmetro impede que o CCMSetup seja um serviço, o que faz por padrão. Quando o CCMSetup funciona como um serviço, funciona no contexto da conta do Sistema Local do computador. Esta conta pode não ter direitos suficientes de acesso aos recursos de rede necessários para a instalação. Com /noservice, CCMSetup.exe funciona no contexto da conta de utilizador que utiliza para iniciar a instalação.

Exemplo: ccmsetup.exe /noservice

/regtoken

A partir da versão 2002, utilize este parâmetro para fornecer um token de registo a granel. Um dispositivo baseado na Internet utiliza este símbolo no processo de registo através de um gateway de gestão de nuvem (CMG). Para obter mais informações, consulte a autenticação baseada em Token para CMG.

Ao utilizar este parâmetro, inclua também os seguintes parâmetros e propriedades:

• /mp
• CCMHOSTNAME
• CÓDIGO SMSSITE
• 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

/redação

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

Exemplo: ccmsetup.exe /retry:20

/service

Especifica que o CCMSetup deve funcionar como um serviço que utiliza a conta do Sistema Local.

Exemplo: ccmsetup.exe /service

/skipprereq

Este parâmetro especifica que CCMSetup.exe não instala o pré-requisito especificado. Pode introduzir mais do que um valor. Utilize o caracteres de 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 Windows pré-requisitosdo cliente.

/fonte

Especifica a localização do download do ficheiro. Use um caminho local ou UNC. O dispositivo descarrega ficheiros utilizando o protocolo do bloco de mensagens do servidor (SMB). Para utilizar/fonte, a conta de utilizador Windows para as necessidades de instalação do cliente Leia as permissões para o local.

Para obter mais informações sobre como o ccmsetup descarrega conteúdo, consulte os grupos Boundary - instalação do cliente. Este artigo também inclui detalhes do comportamento do ccmsetup se utilizar parâmetros de /mp e /source.

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

/uninstall

Utilize este parâmetro para desinstalar o cliente Gestor de Configuração. Para mais informações, consulte Desinstalar o cliente.

Exemplo: ccmsetup.exe /uninstall

/UsePKICert

Especifique este parâmetro para que o cliente utilize um certificado de autenticação do cliente PKI. Se não incluir este parâmetro, ou se o cliente não conseguir encontrar um certificado válido, filtra todos os pontos de gestão HTTPS, incluindo gateways de gestão de nuvem (CMG). O cliente utiliza uma ligação HTTP com um certificado auto-assinado.

Exemplo: CCMSetup.exe /UsePKICert

Se um dispositivo utilizar Azure Ative Directory (Azure AD) para autenticação do cliente e tiver também um certificado de autenticação de cliente baseado em PKI, se utilizar incluir este parâmetro, o cliente não poderá obter informações de bordo da Azure AD a partir de um gateway de gestão de nuvem (CMG). Para um cliente que utiliza a autenticação AD Azure, não especifique este parâmetro, mas inclua as propriedades AADRESOURCEURI e AADCLIENTAPPID.

CCMSetup.exe códigos de devolução

O comando CCMSetup.exe fornece os seguintes códigos de devolução. Para resolver problemas, reveja %WinDir%\ccmsetup\Logs\ccmsetup.log o contexto do cliente e detalhes adicionais sobre os códigos de devolução.

Código de retorno	Significado
0	Com êxito
6	Erro
7	Reinício necessário
8	Programa de configuração já em execução
9	Falha de avaliação de pré-requisitos
10	Falha de validação de hash do manifesto de configuração

Ccmsetup.msi propriedades

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

CCMSETUPCMD

Use este ccmsetup. propriedade MSI para passar parâmetros e propriedades adicionais da linha de comando para ccmsetup. exe. Incluir outros parâmetros e propriedades dentro das aspas " (). Utilize esta propriedade quando ligar o cliente Do Gestor de Configuração com o método de instalação Intune MDM.

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

Client.msi propriedades

As seguintes propriedades podem modificar o comportamento de instalação de client.msi, que ccmsetup.exe instala. Se utilizar o método de instalação pushdo cliente, especifique estas propriedades no separador Cliente das Propriedades de Instalação do Cliente Push na consola Do Gestor de Configuração.

AADCLIENTAPPID

Especifica o identificador de aplicativos de cliente Azure Ative Directory (Azure AD). Cria ou importa a aplicação do cliente quando configura os serviços Azure para a Cloud Management. Um administrador da Azure pode obter o valor desta propriedade a partir do portal Azure. Para mais informações, consulte o ID da aplicação. Para a propriedade AADCLIENTAPPID, este ID de aplicação é para o tipo de aplicação nativa.

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

AADRESOURCEURI

Especifica o identificador de aplicações de servidor AZure AD. Cria ou importa a aplicação do servidor quando configura os serviços Azure para a Cloud Management. Quando cria a aplicação do servidor, na janela 'Aplicação do Servidor Criar', esta propriedade é a App ID URI.

Um administrador da Azure pode obter o valor desta propriedade a partir do portal Azure. Em Azure Ative Directory, encontre a aplicação do servidor nos registos da App. Procure aplicações tipo aplicação Web / API tipo de aplicação. Abra a aplicação, selecione Definições e, em seguida, selecione Propriedades. Utilize o valor ID URI da app para esta propriedade de instalação de clientes AADRESOURCEURI.

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

AADTENANTID

Especifica o identificador de inquilino Azure AD. O Gestor de Configuração liga-se a este inquilino quando configurar serviços Azure para Gestão de Cloud. Para obter o valor deste imóvel, utilize os seguintes passos:

• Num dispositivo Windows 10 que se junta ao mesmo inquilino da AD AZure, abra um pedido de comando.

• Executar o seguinte comando: dsregcmd.exe /status

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

  Nota

  Um administrador da Azure também pode obter este valor no portal Azure. Para mais informações, consulte a identificação do inquilino.

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

CCMADMINS

Especifica uma ou mais contas ou grupos de utilizadores do Windows a que deve ser dado acesso a definições e políticas de cliente. Esta propriedade é útil quando não tem credenciais administrativas locais no computador cliente. Especificar uma lista de contas separadas por pontos-e-vírguis ; ().

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

CCMALLOWSILENTREBOOT

Se necessário, deixe o computador reiniciar 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 liga à intranet, desa esta propriedade para 1 . O tipo de ligação do cliente apresenta Sempre Internet.

Utilize esta propriedade com CCMHOSTNAME para especificar o FQDN do ponto de gestão baseado na Internet. Utilize-o também com o parâmetro CCMSetup UsePKICert e a propriedade SMSSITECODE.

Para obter mais informações sobre a gestão de clientes baseados na Internet, consulte Considerações para comunicações de clientes da internet ou uma floresta não fidedqui nemesa.

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

CCMCERTISSUERS

Utilize esta propriedade para especificar a lista de emitentes de certificados. Esta lista inclui informações de certificados para as autoridades de certificação de raiz fidedignas (CA) que o site do Gestor de Configuração confia.

Este valor é uma correspondência sensível a casos para atributos de assunto que estão no certificado de CA raiz. Atributos separados por uma vírgula , () ou um ponto e vírgula ( ; ). Especifique mais de um certificado de CA raiz utilizando 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."

Para obter mais informações sobre a lista de emitentes de certificados e como os clientes a utilizam durante o processo de seleção de certificados, consulte o Planeamento para a seleção de certificados para clientes PKI.

CCMCERTSEL

Se o cliente tiver mais de um certificado para comunicação HTTPS, este imóvel especifica os critérios para selecionar um certificado de autenticação de cliente válido.

Utilize as seguintes palavras-chave para pesquisar o nome do sujeito ou nome alternativo do sujeito:

• Objeto: Encontre uma correspondência exata
• SubjectStr: Encontre uma correspondência parcial

Exemplos:

• CCMCERTSEL="Subject:computer1.contoso.com": Procure um certificado com uma correspondência exata do nome do computador computer1.contoso.com no Nome do Sujeito ou no Nome Alternativo do Sujeito.

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

Utilize a palavra-chave SubjectAttr para procurar o identificador de objetos (OID) ou atributos de nome distintos no Nome do Sujeito ou Nome Alternativo sujeito.

Exemplos:

• CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": Procure o atributo da unidade organizacional expresso como identificador de objetos e nomeado Computers .

• CCMCERTSEL="SubjectAttr:OU = Computers": Procura do atributo da unidade organizacional expresso como nome distinto, e nomeado Computers .

Para a lista completa de atributos que pode utilizar para a seleção de certificados, consulte valores de atributos suportados para critérios de seleção de certificados PKI.

Se mais de um certificado corresponder à procura e definir CCMFIRSTCERT para 1 , então o instalador do cliente seleciona o certificado com o período de validade mais longo.

CCMCERTSTORE

Se o instalador do cliente não conseguir localizar um certificado válido na loja de certificados pessoal predefinido para o computador, utilize esta propriedade para especificar um nome alternativo da loja de certificados.

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

CCMDEBUGLOGGING

Esta propriedade permite depurar o registo quando o cliente instala. Esta propriedade faz com que o cliente regisque informações de baixo nível para resolução de problemas. Evite utilizar esta propriedade em locais de produção. Pode ocorrer uma sessão de registo excessivo, o que pode dificultar a procura de informações relevantes nos ficheiros de registo. Também ativar CCMENABLELOGGING.

Valores suportados:

• 0: Desligue a exploração madeireira de depuração (padrão)
• 1: Ligue a exploração madeireira de depurar

Exemplo: CCMSetup.exe CCMDEBUGLOGGING=1

Para obter mais informações, consulte sobre os ficheiros de registo.

CCMENABLELOGGING

O Gestor de Configuração ativa o registo por predefinição.

Valores suportados:

• TRUE: Ligar o registo (padrão)
• FALSE: Desligue a exploração madeireira

Exemplo: CCMSetup.exe CCMENABLELOGGING=TRUE

Para obter mais informações, consulte sobre os ficheiros de registo.

CCMEVALINTERVAL

A frequência em minutos em que funciona a ferramenta de avaliação de saúde do cliente (ccmeval.exe). Especifique um valor inteiro de 1 1440 . Por predefinição, o ccmeval funciona uma vez por dia (1440 minutos).

Exemplo: CCMSetup.exe CCMEVALINTERVAL=1440

Para obter mais informações sobre a avaliação de saúde do cliente, consulte os clientes Monitor.

CCMEVALHOUR

A hora durante o dia em que a ferramenta de avaliação de saúde do cliente (ccmeval.exe) funciona. Especifique um valor inteiro de 0 (meia-noite) para 23 (23:00). Por defeito, o ccmeval corre à meia-noite.

Para obter mais informações sobre a avaliação de saúde do cliente, consulte os clientes Monitor.

CCMFIRSTCERT

Se definir este imóvel 1 para, o cliente seleciona o certificado PKI com o período de validade mais longo.

Exemplo: CCMSetup.exe /UsePKICert CCMFIRSTCERT=1

CCMHOSTNAME

Se o cliente for gerido através da internet, esta propriedade especifica o FQDN do ponto de gestão baseado na Internet.

Não especifique esta 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"

Esta propriedade pode especificar o endereço de um gateway de gestão de nuvem (CMG). Para obter o valor deste imóvel, utilize os seguintes passos:

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

• Num cliente ativo, abra um pedido 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`
  

• Utilize o valor devolvido como está com a propriedade CCMHOSTNAME.

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

CCMHTTPPORT

Especifica a porta para o cliente utilizar quando comunica através de HTTP para servidores do sistema de site. Por predefinição, este valor é 80 .

Exemplo: CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORT

Especifica a porta para o cliente utilizar quando comunica através do HTTPS para servidores do sistema de site. Por predefinição, este valor é 443 .

Exemplo: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

Utilize esta propriedade para definir a pasta para instalar os ficheiros do cliente do Gestor de Configuração. Por predefinição, utiliza %WinDir%\CCM .

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

CCMLOGLEVEL

Utilize esta propriedade para especificar o nível de detalhe para escrever nos ficheiros de registo do Gestor de Configuração.

Valores suportados:

• 0: Verbose
• 1: Predefinição
• 2: Advertências e erros
• 3: Apenas erros

Exemplo: CCMSetup.exe CCMLOGLEVEL=0

Para obter mais informações, consulte sobre os ficheiros de registo.

CCMLOGMAXHISTORY

Quando um ficheiro de registo do Gestor de Configuração atinge o tamanho máximo, o cliente rebatiza-o como uma cópia de segurança e cria um novo ficheiro de registo. Esta propriedade especifica quantas versões anteriores do ficheiro de registo para manter. O valor predefinido é 1. Se definir o valor 0 para, o cliente não mantém nenhum histórico de registos.

Exemplo: CCMSetup.exe CCMLOGMAXHISTORY=5

Para obter mais informações, consulte sobre os ficheiros de registo.

CCMLOGMAXSIZE

Esta propriedade especifica o tamanho máximo do ficheiro de registo em bytes. Quando um tronco cresce para o tamanho especificado, o cliente renomea-o como um ficheiro 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

Desa esta propriedade TRUE para impedir que os administradores mudem o site atribuído no painel de controlo do Gestor de Configuração.

Exemplo: CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

Se definido para TRUE, esta propriedade desativa a capacidade dos utilizadores administrativos de alterarem as definições de pasta de cache do cliente no painel de controlo do Gestor de Configuração.

Exemplo: CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIX

Especifique um domínio DNS para que os clientes localizem pontos de gestão que publique no DNS. Quando o cliente localiza um ponto de gestão, fala ao cliente sobre outros pontos de gestão na hierarquia. Este comportamento significa que o ponto de gestão que o cliente encontra no DNS pode ser qualquer um na hierarquia.

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

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

FSP

Especifique o ponto de estado de retorno que recebe e processa mensagens de estado enviadas pelos clientes do Gestor de Configuração.

Para obter mais informações, consulte determine se precisa de um ponto de situação de recuo.

Exemplo: CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

Se definir esta propriedade para TRUE , o instalador do cliente não verifica a versão mínima exigida da Virtualização da Aplicação microsoft (App-V).

Exemplo: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

NOTIFYONLY

Quando ativa esta propriedade, o cliente reporta o estado, mas não remedia os problemas que encontra.

Exemplo: CCMSetup.exe NOTIFYONLY=TRUE

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

PROVISÕES

A partir da versão 2002, use esta propriedade para iniciar uma sequência de tarefas num cliente depois de se registar com sucesso no site.

Por exemplo, você disponibiliza um novo dispositivo Windows 10 com Windows Autopilot, matricula-o automaticamente para Microsoft Intune e, em seguida, instale o cliente Gestor de Configuração para cogestão. Se especificar esta nova opção, o cliente recém-atado executa uma sequência de tarefa. Este processo dá-lhe flexibilidade adicional para instalar aplicações e atualizações de software, ou configurar definições.

Utilize o seguinte processo:

1. Crie uma sequência de tarefas de implementação não-OS para instalar aplicações, instalar atualizações de software e configurar definições.

2. Implemente esta sequência de tarefas para a nova coleção incorporada, Todos os Dispositivos de Provisionamento. Note o ID de implementação da sequência de tarefa, por exemplo PRI20001 .

   Dica

   O propósito da implantação pode ser disponível ou necessário. Uma vez que especifica o ID de implementação como o valor da propriedade, o propósito não importa.

3. Instale o cliente Gestor de Configuração num dispositivo utilizando ccmsetup.msi, e inclua a seguinte propriedade: PROVISIONTS=PRI20001 . Desa parte para o valor desta propriedade como iD de implementação da sequência de tarefas.

   • Se estiver a instalar o cliente da Intune durante a inscrição em cogestão, consulte Como preparar dispositivos baseados na Internet para cogestão.

     Nota

     Este método pode ter pré-requisitos adicionais. Por exemplo, inscrever o site para Azure Ative Directory ou criar um portal de gestão de nuvem ativado por conteúdos.

     Independentemente do método, utilize apenas esta propriedade com ccmsetup.msi.

Após a instalação e registos adequados do cliente no site, inicia a sequência de tarefas referenciada. Se o registo do cliente falhar, a sequência de tarefas não será iniciada.

RESETKEYINFORMATION

Se um cliente tiver a chave de raiz fidedigna do Gestor de Configuração errada, não pode contactar um ponto de gestão fidedigno para receber a nova chave raiz fidedigna. Use esta propriedade para remover a velha chave de raiz de confiança. Esta situação pode ocorrer quando se desloca um cliente de uma hierarquia de site para outra. Esta propriedade aplica-se a clientes que utilizam a comunicação de cliente por HTTP e HTTPS. Para obter mais informações, consulte Planeamento para a chave raiz fidedigna.

Exemplo: CCMSetup.exe RESETKEYINFORMATION=TRUE

SITEREASSIGN

Permite a reatribuição automática de sites para atualizações de clientes quando utilizadas com SMSSITECODE=AUTO.

Exemplo: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE

SMSCACHEDIR

Especifica a localização da pasta cache do cliente no computador cliente. Por predefinição, a localização da cache é %WinDir%\ccmcache .

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

Utilize este imóvel com a propriedade SMSCACHEFLAGS para controlar a localização da pasta cache do cliente. Por exemplo, instalar a pasta cache do cliente na maior unidade de disco do cliente disponível: CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE

SMSCACHEFLAGS

Utilize esta propriedade para especificar mais detalhes de instalação para a pasta cache do cliente. Pode utilizar propriedades SMSCACHEFLAGS individualmente ou em combinação separadas por pontos-e-tíricos ; ().

Se você não incluir esta propriedade:

• O cliente instala a pasta cache de acordo com a propriedade SMSCACHEDIR
• A pasta não é comprimido.
• O cliente usa a propriedade SMSCACHESIZE como limite de tamanho em MB da cache

Quando atualiza um cliente existente, o instalador do cliente ignora esta propriedade.

Valores para a propriedade SMSCACHEFLAGS

• PERCENTDISKSPACE: Desa ajuste o tamanho da cache em percentagem do espaço total do disco. Se especificar este imóvel, também definir SMSCACHESIZE para um valor percentual.

• PERCENTFREEDISKSPACE: Desa ajuste o tamanho da cache em percentagem do espaço do disco livre. Se especificar este imóvel, também definir SMSCACHESIZE como um valor percentual. Por exemplo, o disco tem 10 MB grátis e SMSCACHESIZE=50 especifica. O instalador do cliente define o tamanho da cache para 5 MB. Você não pode usar esta propriedade com a propriedade PERCENTDISKSPACE.

• MAXDRIVE: Instale a cache no maior disco disponível. Se especificar um caminho com a propriedade SMSCACHEDIR, o instalador do cliente ignora este valor.

• MAXDRIVESPACE: Instale a cache na unidade do disco com o espaço mais livre. Se especificar um caminho com a propriedade SMSCACHEDIR, o instalador do cliente ignora este valor.

• NTFSONLY: Instale apenas a cache numa unidade de disco formatada NTFS. Se especificar um caminho com a propriedade SMSCACHEDIR, o instalador do cliente ignora este valor.

• COMPRESS: Guarde a cache de forma comprimido.

• FAILIFNOSPACE: Se não houver espaço suficiente para instalar a cache, remova o cliente Gestor de Configuração.

Exemplo: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

Quando atualiza um cliente existente, o instalador do cliente ignora esta definição. O cliente também ignora o tamanho da cache quando descarrega atualizações de software.

Exemplo: CCMSetup.exe SMSCACHESIZE=100

SMSCONFIGSOURCE

Utilize esta propriedade para especificar a localização e encomendar que o instalador do cliente verifique as definições de configuração. É uma sequência de um ou mais caracteres, cada um definindo uma fonte de configuração específica:

• R: Verifique as definições de configuração no registo.

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

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

• M: Verifique as definições existentes quando atualizar um cliente mais velho.

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

Por predefinição, o instalador do cliente utiliza PU . Verifica primeiro as propriedades de instalação P e, em seguida, as definições existentes ( U ).

Exemplo: CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMP

Especifica um ponto de gestão inicial para o cliente Gestor de Configuração utilizar.

Exemplos:

• CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSPUBLICROOTKEY

Se o cliente não conseguir obter a chave de raiz fidedigna do Gestor de Configuração dos Serviços de Domínio do Diretório Ativo, utilize esta propriedade para especificar a chave. Esta propriedade aplica-se aos clientes que utilizam comunicação HTTP e HTTPS. Para obter mais informações, consulte Planeamento para a chave raiz fidedigna.

Exemplo: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

SMSROOTKEYPATH

Utilize esta propriedade para reinstalar a chave de raiz fidedigna do Gestor de Configuração. Especifica o caminho e o nome completos de um ficheiro que contém a chave de raiz fidedigna. Esta propriedade aplica-se a clientes que utilizam a comunicação de cliente por HTTP e HTTPS. Para obter mais informações, consulte Planeamento para a chave raiz fidedigna.

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

SMSSIGNCERT

Especifica o caminho e o nome completos do certificado auto-assinado exportado no servidor do site. O servidor do site armazena este certificado na loja de certificados SMS. Tem o Servidor do Site do Nome de Assunto e o Certificado de Assinatura do Servidor do Servidor do Site de nome amigável .

Exporte o certificado sem a chave privada, guarde o ficheiro de forma segura e aceda-o apenas a partir de um canal seguro.

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

SMSSITECODE

Esta propriedade especifica um site do Gestor de Configuração ao qual atribui o cliente. Este valor pode ser um código de site de três caracteres ou a palavra AUTO . Se AUTO especificar, ou não especificar esta propriedade, o cliente tenta determinar a sua atribuição do site a partir de Serviços de Domínio do Diretório Ativo ou de um ponto de gestão especificado. Para ativar AUTO as atualizações do cliente, desatar também SITEREASSIGN=TRUE.

Exemplo: CCMSetup.exe SMSSITECODE=XZY

Valores de atributos para critérios de seleção de certificados

O Gestor de Configuração suporta os seguintes valores de atributos para os critérios de seleção de certificados PKI:

Atributo OID	Atributo de Nome Único	Definição do atributo
0.9.2342.19200300.100.1.25	DC	Componente do domínio
1.2.840.113549.1.9.1	E ou E-mail	Endereço de e-mail
2.5.4.3	CN	Nome comum
2.5.4.4	SN	Nome do requerente
2.5.4.5	SERIALNUMBER	Número de série
2.5.4.6	C	Indicativo do país
2.5.4.7	L	Localização
2.5.4.8	S ou ST	Nome do estado ou distrito
2.5.4.9	STREET	Morada
2.5.4.10	O	Nome da organização
2.5.4.11	OU	Unidade organizacional
2.5.4.12	T ou Title	Título
2.5.4.42	G ou GN ou GivenName	Nome próprio
2.5.4.43	I ou Initials	Iniciais
2.5.29.17	(sem valor)	Nome Alternativo do Requerente