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

Nota

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

Importante

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

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.

Dica

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

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.

Nota

Quando utilizar o parâmetro /AlwaysExcludeUpgrade, a atualização automática ainda funciona. No entanto, quando o CCMSetup correr para realizar a atualização, observará que /AlwaysExcludeUpgrade parâmetro foi definido e registará a seguinte linha no ccmsetup.log:

Client is stamped with /alwaysexcludeupgrade. Stop proceeding.

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

/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.

Nota

ClientUI é o único valor que o parâmetro /ExcluiFeatures suporta.

/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.

Importante

Este parâmetro especifica um ponto de gestão inicial para os computadores encontrarem uma fonte de descarregamento, e pode ser qualquer ponto de gestão em qualquer site. Não atribui o cliente ao ponto de gestão especificado.

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

Importante

Ao especificar o URL de uma porta de gestão de nuvem para o parâmetro /mp, deve começar por https:// .

/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

Dica

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

/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.

Dica

Se estiver a utilizar um script para executar CCMSetup.exe com o parâmetro /serviço, CCMSetup.exe sai após o início do serviço. Pode não reportar corretamente detalhes de instalação ao script.

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.

Dica

Pode utilizar o parâmetro /origem mais de uma vez numa linha de comando para especificar locais de descarregamento alternativos.

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.

Nota

Em alguns cenários, não precisa de especificar este parâmetro, mas ainda utilizar um certificado de cliente. Por exemplo, a instalação de clientes com base em impulsos de clientes e de atualização de software. Utilize este parâmetro quando instalar manualmente um cliente e utilize o parâmetro /mp com um ponto de gestão ativado por HTTPS.

Especificar também este parâmetro quando instalar um cliente para comunicação apenas na Internet. Utilize CCMALWAYSINF=1 juntamente com as propriedades para o ponto de gestão baseado na Internet (CCMHOSTNAME) e o código do site (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.

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"

Dica

Microsoft Intune limita a linha de comando a 1024 caracteres.

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.

Importante

Quando utiliza esta propriedade, o computador reinicia sem aviso prévio. Este comportamento ocorre mesmo que um utilizador esteja inscrito na Windows.

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."

Dica

Utilize o valor do certificado AtributoIssuers no ficheiro mobileclient.tcf para o site. Este ficheiro está na \bin\<platform> sub-dobradeira do diretório de instalação do Gestor de Configuração no servidor do site.

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 .

Importante

Se utilizar o Nome do Assunto, a palavra-chave assunto é sensível a casos e a palavra-chave SubjectStr é insensível a caso.

Se utilizar o Nome Alternativo do Assunto, tanto as palavras-chave Subject como As palavras-chave SubjectStr são insensíveis a caso.

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

Importante

Quando especificar o endereço de um CMG para a propriedade CCMHOSTNAME, não apeta um prefixo como https:// . Utilize apenas este prefixo com o URL /mp de um CMG.

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 .

Dica

Independentemente de onde instalar os ficheiros do cliente, instala sempre o ficheiro ccmcore.dll na %WinDir%\System32 pasta. Num sistema operativo de 64 bits, instala uma cópia de ccmcore.dll na %WinDir%\SysWOW64 pasta. Este ficheiro suporta aplicações de 32 bits que utilizam a versão de 32 bits das APIs do cliente a partir do Gestor de Configuração SDK.

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.

Nota

Não precisa especificar esta propriedade se o cliente estiver no mesmo domínio que um ponto de gestão publicado. Nesse caso, o domínio do cliente é automaticamente utilizado para pesquisar pontos de gestão dns.

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.

Nota

Por predefinição, o Gestor de Configuração não permite a publicação de DNS.

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).

Importante

Se instalar o cliente Gestor de Configuração sem instalar o App-V, não poderá implementar aplicações virtuais.

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.

Nota

Se a sequência de tarefas instalar atualizações de software ou aplicações, os clientes precisam de um certificado de autenticação de clientes válido. A autenticação simbólica por si só não funciona. Para obter mais informações, consulte notas de lançamento - implementação de SO.

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

Importante

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

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

Nota

Se reinstalar um cliente, não pode utilizar SMSCACHESIZE ou SMSCACHEFLAGS para definir o tamanho da cache para ser menor do que era anteriormente. O tamanho anterior é o valor mínimo.

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.

Importante

Se o ponto de gestão apenas aceitar ligações com o cliente em HTTPS, prefixe o nome do ponto de gestão com https:// .

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>

Dica

Obtenha o valor da chave de raiz fidedigna do site a partir do ficheiro mobileclient.tcf no servidor do site. Para obter mais informações, consulte pré-fornecimento de um cliente com a chave raiz fidedigna utilizando um ficheiro.

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.

Nota

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

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