Sobre os parâmetros e propriedades de instalação do cliente no Gestor de ConfiguraçãoAbout client installation parameters and properties in Configuration Manager

Aplica-se a: Gestor de Configuração (ramo atual)Applies to: Configuration Manager (current branch)

Utilize o comando CCMSetup.exe para instalar o cliente Gestor de Configuração.Use the CCMSetup.exe command to install the Configuration Manager client. Se fornecer parâmetros de instalação do cliente na linha de comando, eles modificam o comportamento de instalação.If you provide client installation parameters on the command line, they modify the installation behavior. Se fornecer propriedades de instalação do cliente na linha de comando, modificam a configuração inicial do agente cliente instalado.If you provide client installation properties on the command line, they modify the initial configuration of the installed client agent.

Sobre CCMSetup.exeAbout CCMSetup.exe

O comando CCMSetup.exe descarrega ficheiros necessários para instalar o cliente a partir de um ponto de gestão ou de uma localização de origem.The CCMSetup.exe command downloads needed files to install the client from a management point or a source location. Estes ficheiros podem incluir:These files might include:

  • O cliente do pacote do Windows Installer.msi que instala o software do clienteThe Windows Installer package client.msi that installs the client software

  • Pré-requisitos do clienteClient prerequisites

  • Atualizações e correções para o cliente Gestor de ConfiguraçãoUpdates and fixes for the Configuration Manager client

Nota

Não pode instalar diretamente o cliente.MSI.You can't directly install client.msi.

CCMSetup.exe fornece parâmetros de linha de comando para personalizar a instalação.CCMSetup.exe provides command-line parameters to customize the installation. Os parâmetros são pré-fixados com um corte / () e por convenção são maiuso.Parameters are prefixed with a slash (/) and by convention are lower case. Especificar o valor de um parâmetro quando necessário usando um cólon : () imediatamente seguido pelo valor.You specify the value of a parameter when necessary using a colon (:) immediately followed by the value. Para obter mais informações, consulte os parâmetros da linha de comando CCMSetup.exe.For more information, see CCMSetup.exe command-line parameters.

Também pode fornecer propriedades na linha de comando CCMSetup.exe para modificar o comportamento do cliente.msi.Properties por convenção são maiúsculas.You can also supply properties at the CCMSetup.exe command line to modify the behavior of client.msi.Properties by convention are upper case. Você especifica um valor para um imóvel usando um sinal igual = () imediatamente seguido pelo valor.You specify a value for a property using an equal sign (=) immediately followed by the value. Para mais informações, consulte as propriedades do Cliente.msi.For more information, see Client.msi properties.

Importante

Especifique os parâmetros CCMSetup antes de especificar propriedades para cliente.msi.Specify CCMSetup parameters before you specify properties for client.msi.

CCMSetup.exe e os ficheiros de suporte encontram-se no servidor do site na pasta cliente da pasta de instalação do Gestor de Configuração.CCMSetup.exe and the supporting files are on the site server in the Client folder of the Configuration Manager installation folder. O Gestor de Configuração partilha esta pasta para a rede sob a partilha do site.Configuration Manager shares this folder to the network under the site share. Por exemplo, \\SiteServer\SMS_ABC\Client.For example, \\SiteServer\SMS_ABC\Client.

Na linha de comandos, o comando CCMSetup.exe utiliza o seguinte formato:At the command prompt, the CCMSetup.exe command uses the following format:

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

Por exemplo:For example:

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

Este exemplo faz as seguintes coisas:This example does the following things:

  • 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.Specifies the management point named SMSMP01 to request a list of distribution points to download the client installation files.

  • Especifica que a instalação deve parar se já existir uma versão do cliente no computador.Specifies that installation should stop if a version of the client already exists on the computer.

  • Indica ao client.msi que atribua o código de site S01 ao cliente.Instructs client.msi to assign the client to the site code S01.

  • Indica ao client.msi que utilize o ponto de estado de contingência com o nome SMSFP01.Instructs client.msi to use the fallback status point named SMSFP01.

Dica

Se um valor de parâmetro tiver espaços, rodeie-o com aspas.If a parameter value has spaces, surround it with quotation marks.

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.If you extend the Active Directory schema for Configuration Manager, the site publishes many client installation properties in Active Directory Domain Services. O cliente Do Gestor de Configuração lê automaticamente estas propriedades.The Configuration Manager client automatically reads these properties. Para mais informações, consulte sobre as propriedades de instalação do cliente publicadas nos Serviços de Domínio do Diretório AtivoFor more information, see About client installation properties published to Active Directory Domain Services

Parâmetros de linha de comando CCMSetup.exeCCMSetup.exe command-line parameters

/?/?

Mostra os parâmetros disponíveis da linha de comando para ccmsetup.exe.Shows available command-line parameters for ccmsetup.exe.

Exemplo: ccmsetup.exe /?Example: ccmsetup.exe /?

/fonte/source

Especifica a localização do download do ficheiro.Specifies the file download location. Use um caminho local ou UNC.Use a local or UNC path. O dispositivo descarrega ficheiros utilizando o protocolo do bloco de mensagens do servidor (SMB).The device downloads files using the server message block (SMB) protocol. Para utilizar /fonte, a conta do utilizador do Windows para instalação do cliente precisa De ler permissões para a localização.To use /source, the Windows user account for client installation needs Read permissions to the location.

Para obter mais informações sobre como o ccmsetup descarrega conteúdo, consulte os grupos Boundary - instalação do cliente.For more information on how ccmsetup downloads content, see Boundary groups - client installation. Este artigo também inclui detalhes do comportamento do ccmsetup se utilizar parâmetros de /mp e /source.That article also includes details of ccmsetup behavior if you use both /mp and /source parameters.

Dica

Pode utilizar o parâmetro /origem mais de uma vez numa linha de comando para especificar locais de descarregamento alternativos.You can use the /source parameter more than once in a command line to specify alternative download locations.

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

/mp/mp

Especifica um ponto de gestão de origem para os computadores se conectarem.Specifies a source management point for computers to connect to. Os computadores utilizam este ponto de gestão para encontrar o ponto de distribuição mais próximo dos ficheiros de instalação.Computers use this management point to find the nearest distribution point for the installation files. 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.If there are no distribution points, or computers can't download the files from the distribution points after four hours, they download the files from the specified management point.

Para obter mais informações sobre como o ccmsetup descarrega conteúdo, consulte os grupos Boundary - instalação do cliente.For more information on how ccmsetup downloads content, see Boundary groups - client installation. Este artigo também inclui detalhes do comportamento do ccmsetup se utilizar parâmetros de /mp e /source.That article also includes details of ccmsetup behavior if you use both /mp and /source parameters.

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.This parameter specifies an initial management point for computers to find a download source, and can be any management point in any site. Não atribui o cliente ao ponto de gestão especificado.It doesn't assign the client to the specified management point.

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.Computers download the files over an HTTP or HTTPS connection, depending on the site system role configuration for client connections. O download também pode usar o estrangulamento BITS se o configurar.The download can also use BITS throttling if you configure it. 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.If you configure all distribution points and management points for HTTPS client connections only, verify that the client computer has a valid client certificate.

Pode utilizar o parâmetro da linha de comando /mp para especificar mais de um ponto de gestão.You can use the /mp command-line parameter to specify more than one management point. Se o computador não conseguir ligar-se ao primeiro, tenta o seguinte na lista especificada.If the computer fails to connect to the first one, it tries the next in the specified list. Quando especificar vários pontos de gestão, separe os valores por pontos de sedição.When you specify multiple management points, separate the values by semicolons.

Se o cliente ligar a um ponto de gestão utilizando HTTPS, especifique o FQDN e não o nome do computador.If the client connects to a management point using HTTPS, specify the FQDN not the computer name. O valor deve corresponder ao nome de objeto ou alternativa docertificado PKI do ponto de gestão.The value must match the management point PKI certificate's Subject or Subject Alternative Name. 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.Although Configuration Manager supports using a computer name in the certificate for connections on the intranet, using an FQDN is recommended.

Exemplo com o nome do computador:ccmsetup.exe /mp:SMSMP01Example with the computer name: ccmsetup.exe /mp:SMSMP01

Exemplo com o FQDN:ccmsetup.exe /mp:smsmp01.contoso.comExample with the 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).This parameter can also specify the URL of a cloud management gateway (CMG). Utilize este URL para instalar o cliente num dispositivo baseado na Internet.Use this URL to install the client on an internet-based device. Para obter o valor deste parâmetro, utilize os seguintes passos:To get the value for this parameter, use the following steps:

  • Criar um CMG.Create a CMG. Para obter mais informações, consulte Configurar um CMG.For more information, see Set up a CMG.

  • Num cliente ativo, abra um pedido de comando Do Windows PowerShell como administrador.On an active client, open a Windows PowerShell command prompt as an administrator.

  • Execute o seguinte comando:Run the following command:

    (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.Append the https:// prefix to use with the /mp parameter.

Exemplo para quando utilizar o URL de gateway de gestão de nuvem:ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100Example for when you use the cloud management gateway URL: 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:// .When specifying the URL of a cloud management gateway for the /mp parameter, it must start with https://.

/regtoken/regtoken

A partir da versão 2002, utilize este parâmetro para fornecer um token de registo a granel.Starting in version 2002, use this parameter to provide a bulk registration token. Um dispositivo baseado na Internet utiliza este símbolo no processo de registo através de um gateway de gestão de nuvem (CMG).An internet-based device uses this token in the registration process through a cloud management gateway (CMG). Para obter mais informações, consulte a autenticação baseada em Token para CMG.For more information, see Token-based authentication for CMG.

Ao utilizar este parâmetro, inclua também os seguintes parâmetros e propriedades:When you use this parameter, also include the following parameters and properties:

A linha de comando de exemplo a seguir inclui os outros parâmetros e propriedades de configuração necessários:The following example command line includes the other required setup parameters and properties:

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

Se o CCMSetup.exe não descarregar ficheiros de instalação, utilize este parâmetro para especificar o intervalo de repetição em minutos.If CCMSetup.exe fails to download installation files, use this parameter to specify the retry interval in minutes. O CCMSetup continua a tentar novamente até atingir o limite especificado no parâmetro /downloadtimeout.CCMSetup continues to retry until it reaches the limit specified in the /downloadtimeout parameter.

Exemplo: ccmsetup.exe /retry:20Example: ccmsetup.exe /retry:20

/noservice/noservice

Este parâmetro impede que o CCMSetup seja um serviço, o que faz por padrão.This parameter prevents CCMSetup from running as a service, which it does by default. Quando o CCMSetup funciona como um serviço, funciona no contexto da conta do Sistema Local do computador.When CCMSetup runs as a service, it runs in the context of the Local System account of the computer. Esta conta pode não ter direitos suficientes de acesso aos recursos de rede necessários para a instalação.This account might not have sufficient rights to access required network resources for the installation. Com /noservice, o CCMSetup.exe funciona no contexto da conta de utilizador que utiliza para iniciar a instalação.With /noservice, CCMSetup.exe runs in the context of the user account that you use to start the installation.

Exemplo: ccmsetup.exe /noserviceExample: ccmsetup.exe /noservice

/service/service

Especifica que o CCMSetup deve funcionar como um serviço que utiliza a conta do Sistema Local.Specifies that CCMSetup should run as a service that uses the Local System account.

Dica

Se estiver a utilizar um script para executar CCMSetup.exe com o parâmetro /serviço, o CCMSetup.exe sai após o início do serviço.If you're using a script to run CCMSetup.exe with the /service parameter, CCMSetup.exe exits after the service starts. Pode não reportar corretamente detalhes de instalação ao script.It might not correctly report installation details to the script.

Exemplo: ccmsetup.exe /serviceExample: ccmsetup.exe /service

/uninstall/uninstall

Utilize este parâmetro para desinstalar o cliente Gestor de Configuração.Use this parameter to uninstall the Configuration Manager client. Para mais informações, consulte Desinstalar o cliente.For more information, see Uninstall the client.

Exemplo: ccmsetup.exe /uninstallExample: ccmsetup.exe /uninstall

/logon/logon

Se alguma versão do cliente já estiver instalada, este parâmetro especifica que a instalação do cliente deve parar.If any version of the client is already installed, this parameter specifies that the client installation should stop.

Exemplo: ccmsetup.exe /logonExample: ccmsetup.exe /logon

/forcereboot/forcereboot

Utilize este parâmetro para forçar o computador a reiniciar, se necessário, para completar a instalação.Use this parameter to force the computer to restart if necessary to complete the installation. Se não especificar este parâmetro, o CCMSetup sai quando é necessário reiniciar.If you don't specify this parameter, CCMSetup exits when a restart is necessary. Em seguida, continua após o próximo reinício manual.It then continues after the next manual restart.

Exemplo: CCMSetup.exe /forcerebootExample: CCMSetup.exe /forcereboot

/BITSPriority/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.When the device downloads client installation files over an HTTP connection, use this parameter to specify the download priority. Especificar um dos seguintes valores possíveis:Specify one of the following possible values:

  • FOREGROUND

  • HIGH

  • NORMAL(predefinição)NORMAL (default)

  • LOW

Exemplo: ccmsetup.exe /BITSPriority:HIGHExample: ccmsetup.exe /BITSPriority:HIGH

/downloadtimeout/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.If CCMSetup fails to download the client installation files, this parameter specifies the maximum timeout in minutes. Após este intervalo, o CCMSetup para de tentar descarregar os ficheiros de instalação.After this timeout, CCMSetup stops trying to download the installation files. O valor predefinido é de 1440 minutos (um dia).The default value is 1440 minutes (one day).

Utilize o parâmetro /retry para especificar o intervalo entre tentativas de repetição.Use the /retry parameter to specify the interval between retry attempts.

Exemplo: ccmsetup.exe /downloadtimeout:100Example: ccmsetup.exe /downloadtimeout:100

/UsePKICert/UsePKICert

Especifique este parâmetro para que o cliente utilize um certificado de autenticação do cliente PKI.Specify this parameter for the client to use a PKI client authentication certificate. Se não incluir este parâmetro, ou se o cliente não conseguir encontrar um certificado válido, utiliza uma ligação HTTP com um certificado auto-assinado.If you don't include this parameter, or if the client can't find a valid certificate, it uses an HTTP connection with a self-signed certificate.

Exemplo: CCMSetup.exe /UsePKICertExample: CCMSetup.exe /UsePKICert

Nota

Em alguns cenários, não precisa de especificar este parâmetro, mas ainda utilizar um certificado de cliente.In some scenarios, you don't have to specify this parameter, but still use a client certificate. Por exemplo, a instalação de clientes com base em impulsos de clientes e de atualização de software.For example, client push and software update–based client installation. Utilize este parâmetro quando instalar manualmente um cliente e utilize o parâmetro /mp com um ponto de gestão ativado por HTTPS.Use this parameter when you manually install a client and use the /mp parameter with an HTTPS-enabled management point.

Especificar também este parâmetro quando instalar um cliente para comunicação apenas na Internet.Also specify this parameter when you install a client for internet-only communication. Utilize o imóvel CCMALWAYSINF=1 juntamente com as propriedades do ponto de gestão baseado na Internet (CCMHOSTNAME) e o código do site (SMSSITECODE).Use the CCMALWAYSINF=1 property together with the properties for the internet-based management point (CCMHOSTNAME) and the site code (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.For more information about internet-based client management, see Considerations for client communications from the internet or an untrusted forest.

/NoCRLCheck/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.Specifies that a client shouldn't check the certificate revocation list (CRL) when it communicates over HTTPS with a PKI certificate. Quando não especifica este parâmetro, o cliente verifica o CRL antes de estabelecer uma ligação HTTPS.When you don't specify this parameter, the client checks the CRL before it establishes an HTTPS connection. Para obter mais informações sobre a verificação do cliente CRL, consulte Planeamento para revogação de certificadoS PKI.For more information about client CRL checking, see Planning for PKI certificate revocation.

Exemplo: CCMSetup.exe /UsePKICert /NoCRLCheckExample: CCMSetup.exe /UsePKICert /NoCRLCheck

/config/config

Este parâmetro especifica um ficheiro de texto que lista as propriedades de instalação do cliente.This parameter specifies a text file that lists client installation properties.

  • Se o CCMSetup funciona como um serviço, coloque este ficheiro na pasta do sistema CCMSetup: %Windir%\Ccmsetup .If CCMSetup runs as a service, place this file in the CCMSetup system folder: %Windir%\Ccmsetup.

  • Se especificar o parâmetro /noservice, coloque este ficheiro na mesma pasta que o CCMSetup.exe.If you specify the /noservice parameter, place this file in the same folder as CCMSetup.exe.

Exemplo: CCMSetup.exe /config:"configuration file name.txt"Example: 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.To provide the correct file format, use the mobileclienttemplate.tcf file in the \bin\<platform> folder in the Configuration Manager installation directory on the site server. Este ficheiro tem comentários sobre as secções e como usá-las.This file has comments about the sections and how to use them. Especificar as propriedades de instalação do cliente na [Client Install] secção, após o seguinte texto: Install=INSTALL=ALL .Specify the client installation properties in the [Client Install] section, after the following text: Install=INSTALL=ALL.

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

/skipprereq/skipprereq

Este parâmetro especifica que o CCMSetup.exe não instala o pré-requisito especificado.This parameter specifies that CCMSetup.exe doesn't install the specified prerequisite. Pode introduzir mais do que um valor.You can enter more than one value. Utilize o caracteres de ponto e vírgula ; para separar cada valor.Use the semicolon character (;) to separate each value.

Exemplos:Examples:

  • CCMSetup.exe /skipprereq:dotnetfx40_client_x86_x64.exe

  • CCMSetup.exe /skipprereq:dotnetfx40_client_x86_x64.exe;windowsupdateagent30_x86.exe

Para obter mais informações sobre os pré-requisitos do cliente, consulte os pré-requisitos do cliente windows.For more information on client prerequisites, see Windows client prerequisites.

/forceinstall/forceinstall

Especificar que o CCMSetup.exe desinstala qualquer cliente existente e instala um novo cliente.Specify that CCMSetup.exe uninstalls any existing client, and installs a new client.

/ExcluirFeaturas/ExcludeFeatures

Este parâmetro especifica que o CCMSetup.exe não instala a função especificada.This parameter specifies that CCMSetup.exe doesn't install the specified feature.

Exemplo: CCMSetup.exe /ExcludeFeatures:ClientUI não instala o Software Center no cliente.Example: CCMSetup.exe /ExcludeFeatures:ClientUI doesn't install Software Center on the client.

Nota

ClientUIé o único valor que o parâmetro /ExcluiFeatures suporta.ClientUI is the only value that the /ExcludeFeatures parameter supports.

Códigos de devolução CCMSetup.exeCCMSetup.exe return codes

O comando CCMSetup.exe fornece os seguintes códigos de devolução.The CCMSetup.exe command provides the following return codes. Para resolver problemas, reveja %WinDir%\ccmsetup\ccmsetup.log o contexto do cliente e detalhes adicionais sobre os códigos de devolução.To troubleshoot, review %WinDir%\ccmsetup\ccmsetup.log on the client for context and additional detail about return codes.

Código de retornoReturn code SignificadoMeaning
00 ÊxitoSuccess
66 ErroError
77 Reinício necessárioReboot required
88 Programa de configuração já em execuçãoSetup already running
99 Falha de avaliação de pré-requisitosPrerequisite evaluation failure
1010 Falha de validação de hash do manifesto de configuraçãoSetup manifest hash validation failure

Propriedades ccmsetup.msiCcmsetup.msi properties

As seguintes propriedades podem modificar o comportamento de instalação do ccmsetup.msi.The following properties can modify the installation behavior of ccmsetup.msi.

CCMSETUPCMDCCMSETUPCMD

Use este ccmsetup. propriedade MSI para passar parâmetros e propriedades adicionais da linha de comando para ccmsetup. exe.Use this ccmsetup.msi property to pass additional command-line parameters and properties to ccmsetup.exe. Incluir outros parâmetros e propriedades dentro das aspas " ().Include other parameters and properties inside quotation marks ("). Utilize esta propriedade quando ligar o cliente Do Gestor de Configuração com o método de instalação Intune MDM.Use this property when you bootstrap the Configuration Manager client with the Intune MDM installation method.

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

Dica

O Microsoft Intune limita a linha de comando a 1024 caracteres.Microsoft Intune limits the command line to 1024 characters.

Propriedades cliente.msiClient.msi properties

As seguintes propriedades podem modificar o comportamento de instalação do cliente.msi, que o ccmsetup.exe instala.The following properties can modify the installation behavior of client.msi, which ccmsetup.exe installs. 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.If you use the client push installation method, specify these properties on the Client tab of the Client Push Installation Properties in the Configuration Manager console.

AADCLIENTAPPIDAADCLIENTAPPID

Especifica o identificador de aplicações de cliente Azure Ative (Azure AD).Specifies the Azure Active Directory (Azure AD) client app identifier. Cria ou importa a aplicação do cliente quando configura os serviços Azure para a Cloud Management.You create or import the client app when you configure Azure services for Cloud Management. Um administrador da Azure pode obter o valor desta propriedade a partir do portal Azure.An Azure administrator can get the value for this property from the Azure portal. Para mais informações, consulte o ID da aplicação.For more information, see get application ID. Para a propriedade AADCLIENTAPPID, este ID de aplicação é para o tipo de aplicação nativa.For the AADCLIENTAPPID property, this application ID is for the Native application type.

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

AADRESOURCEURIAADRESOURCEURI

Especifica o identificador de aplicações de servidor AZure AD.Specifies the Azure AD server app identifier. Cria ou importa a aplicação do servidor quando configura os serviços Azure para a Cloud Management.You create or import the server app when you configure Azure services for Cloud Management. Quando cria a aplicação do servidor, na janela 'Aplicação do Servidor Criar', esta propriedade é a App ID URI.When you create the server app, in the Create Server Application window, this property is the App ID URI.

Um administrador da Azure pode obter o valor desta propriedade a partir do portal Azure.An Azure administrator can get the value for this property from the Azure portal. No Azure Ative Directory, encontre a aplicação do servidor nos registos da App.In Azure Active Directory, find the server app under App registrations. Procure aplicações tipo aplicação Web / API tipo de aplicação.Look for application type Web app / API. Abra a aplicação, selecione Definiçõese, em seguida, selecione Propriedades.Open the app, select Settings, and then select Properties. Utilize o valor ID URI da app para esta propriedade de instalação de clientes AADRESOURCEURI.Use the App ID URI value for this AADRESOURCEURI client installation property.

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

AADTENANTIDAADTENANTID

Especifica o identificador de inquilino Azure AD.Specifies the Azure AD tenant identifier. O Gestor de Configuração liga-se a este inquilino quando configurar serviços Azure para Gestão de Cloud.Configuration Manager links to this tenant when you configure Azure services for Cloud Management. Para obter o valor deste imóvel, utilize os seguintes passos:To get the value for this property, use the following steps:

  • Num dispositivo Windows 10 que se junta ao mesmo inquilino AD AZure, abra um pedido de comando.On a Windows 10 device that is joined to the same Azure AD tenant, open a command prompt.

  • Executar o seguinte comando:dsregcmd.exe /statusRun the following command: dsregcmd.exe /status

  • Na secção Estado do Dispositivo, encontre o valor do TenantId.In the Device State section, find the TenantId value. Por exemplo, TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49aFor example, TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49a

    Nota

    Um administrador da Azure também pode obter este valor no portal Azure.An Azure administrator can also obtain this value in the Azure portal. Para mais informações, consulte a identificação do inquilino.For more information, see get tenant ID.

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

CCMADMINSCCMADMINS

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.Specifies one or more Windows user accounts or groups to be given access to client settings and policies. Esta propriedade é útil quando não tem credenciais administrativas locais no computador cliente.This property is useful when you don't have local administrative credentials on the client computer. Especificar uma lista de contas separadas por pontos-e-vírguis ; ().Specify a list of accounts that are separated by semicolons (;).

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

CCMALLOWSILENTREBOOTCCMALLOWSILENTREBOOT

Se necessário, deixe o computador reiniciar silenciosamente após a instalação do cliente.If necessary, allow the computer to silently restart after the client installation.

Importante

Quando utiliza esta propriedade, o computador reinicia sem aviso prévio.When you use this property, the computer restarts without warning. Este comportamento ocorre mesmo que um utilizador esteja inscrito no Windows.This behavior occurs even if a user is signed in to Windows.

Exemplo: CCMSetup.exe CCMALLOWSILENTREBOOTExample: CCMSetup.exe CCMALLOWSILENTREBOOT

CCMALWAYSINFCCMALWAYSINF

Para especificar que o cliente é sempre baseado na Internet e nunca se liga à intranet, desa esta propriedade para 1 .To specify that the client is always internet-based and never connects to the intranet, set this property value to 1. O tipo de ligação do cliente apresenta Sempre Internet.The client's connection type displays Always Internet.

Utilize esta propriedade com CCMHOSTNAME para especificar o FQDN do ponto de gestão baseado na Internet.Use this property with CCMHOSTNAME to specify the FQDN of the internet-based management point. Utilize-o também com o parâmetro CCMSetup /UsePKICert e o código do site(SMSSITECODE).Also use it with the CCMSetup parameter /UsePKICert and the site code (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.For more information about internet-based client management, see Considerations for client communications from the internet or an untrusted forest.

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

CCMCERTISSUERSCCMCERTISSUERS

Utilize esta propriedade para especificar a lista de emitentes de certificados.Use this property to specify the certificate issuers list. 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.This list includes certificate information for the trusted root certification authorities (CA) that the Configuration Manager site trusts.

Este valor é uma correspondência sensível a casos para atributos de assunto que estão no certificado de CA raiz.This value is a case-sensitive match for subject attributes that are in the root CA certificate. Atributos separados por uma vírgula , () ou um ponto e vírgula ( ; ).Separate attributes by a comma (,) or a semicolon (;). Especifique mais de um certificado de CA raiz utilizando uma barra de separador | ().Specify more than one root CA certificate by using a separator bar (|).

Exemplo: CCMCERTISSUERS="CN=Contoso Root CA; OU=Servers; O=Contoso, Ltd; C=US | CN=Litware Corporate Root CA; O=Litware, Inc."Example: 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.Use the value of the CertificateIssuers attribute in the mobileclient.tcf file for the site. Este ficheiro está na \bin\<platform> sub-dobradeira do diretório de instalação do Gestor de Configuração no servidor do site.This file is in the \bin\<platform> subfolder of the Configuration Manager installation directory on the site server.

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.For more information about the certificate issuers list and how clients use it during the certificate selection process, see Planning for PKI client certificate selection.

CCMCERTSELCCMCERTSEL

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.If the client has more than one certificate for HTTPS communication, this property specifies the criteria for it to select a valid client authentication certificate.

Utilize as seguintes palavras-chave para pesquisar o nome do sujeito ou nome alternativo do sujeito:Use the following keywords to search the certificate Subject Name or Subject Alternative Name:

  • Objeto: Encontre uma correspondência exataSubject: Find an exact match
  • SubjectStr: Encontre uma correspondência parcialSubjectStr: Find a partial match

Exemplos:Examples:

  • 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="Subject:computer1.contoso.com": Search for a certificate with an exact match to the computer name computer1.contoso.com in the Subject Name or the Subject Alternative Name.

  • CCMCERTSEL="SubjectStr:contoso.com": Procure um certificado que contenha contoso.com no Nome do Sujeito ou no Nome Alternativo do Sujeito.CCMCERTSEL="SubjectStr:contoso.com": Search for a certificate that contains contoso.com in the Subject Name or the Subject Alternative Name.

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.Use the SubjectAttr keyword to search for the Object Identifier (OID) or distinguished name attributes in the Subject Name or Subject Alternative Name.

Exemplos:Examples:

  • CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": Procure o atributo da unidade organizacional expresso como identificador de objetos e nomeado Computers .CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": Search for the organizational unit attribute expressed as an object identifier and named Computers.

  • CCMCERTSEL="SubjectAttr:OU = Computers": Procura do atributo da unidade organizacional expresso como nome distinto, e nomeado Computers .CCMCERTSEL="SubjectAttr:OU = Computers": Search for the organizational unit attribute expressed as a distinguished name, and named 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.If you use the Subject Name, the Subject keyword is case-sensitive, and the SubjectStr keyword is case-insensitive.

Se utilizar o Nome Alternativo do Assunto, tanto as palavras-chave Subject como As palavras-chave SubjectStr são insensíveis a caso.If you use the Subject Alternative Name, both the Subject and the SubjectStr keywords are case-insensitive.

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.For the complete list of attributes that you can use for certificate selection, see Supported attribute values for PKI certificate selection criteria.

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.If more than one certificate matches the search, and you set CCMFIRSTCERT to 1, then the client installer selects the certificate with the longest validity period.

CCMCERTSTORECCMCERTSTORE

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.If the client installer can't locate a valid certificate in the default Personal certificate store for the computer, use this property to specify an alternate certificate store name.

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

CCMDEBUGLOGGINGCCMDEBUGLOGGING

Esta propriedade permite depurar o registo quando o cliente instala.This property enables debug logging when the client installs. Esta propriedade faz com que o cliente regisque informações de baixo nível para resolução de problemas.This property causes the client to log low-level information for troubleshooting. Evite utilizar esta propriedade em locais de produção.Avoid using this property in production sites. Pode ocorrer uma sessão de registo excessivo, o que pode dificultar a procura de informações relevantes nos ficheiros de registo.Excessive logging can occur, which might make it difficult to find relevant information in the log files. Também ativar CCMENABLELOGGING.Also enable CCMENABLELOGGING.

Valores suportados:Supported values:

  • 0: Desligue a exploração madeireira de depuração (padrão)0: Turn off debug logging (default)
  • 1: Ligue a exploração madeireira de depurar1: Turn on debug logging

Exemplo: CCMSetup.exe CCMDEBUGLOGGING=1Example: CCMSetup.exe CCMDEBUGLOGGING=1

Para obter mais informações, consulte sobre os ficheiros de registo.For more information, see About log files.

CCMENABLELOGGINGCCMENABLELOGGING

O Gestor de Configuração ativa o registo por predefinição.Configuration Manager enables logging by default.

Valores suportados:Supported values:

  • TRUE: Ligar o registo (padrão)TRUE: Turn on logging (default)
  • FALSE: Desligue a exploração madeireiraFALSE: Turn off logging

Exemplo: CCMSetup.exe CCMENABLELOGGING=TRUEExample: CCMSetup.exe CCMENABLELOGGING=TRUE

Para obter mais informações, consulte sobre os ficheiros de registo.For more information, see About log files.

CCMEVALINTERVALCCMEVALINTERVAL

A frequência em minutos em que funciona a ferramenta de avaliação de saúde do cliente (ccmeval.exe).The frequency in minutes at which the client health evaluation tool (ccmeval.exe) runs. Especifique um valor inteiro de 1 1440 .Specify an integer value from 1 to 1440. Por predefinição, o ccmeval funciona uma vez por dia (1440 minutos).By default, ccmeval runs once a day (1440 minutes).

Exemplo: CCMSetup.exe CCMEVALINTERVAL=1440Example: CCMSetup.exe CCMEVALINTERVAL=1440

Para obter mais informações sobre a avaliação de saúde do cliente, consulte os clientes Monitor.For more information on client health evaluation, see Monitor clients.

CCMEVALHOURCCMEVALHOUR

A hora durante o dia em que a ferramenta de avaliação de saúde do cliente (ccmeval.exe) funciona.The hour during the day when the client health evaluation tool (ccmeval.exe) runs. Especifique um valor inteiro de 0 (meia-noite) para 23 (23:00).Specify an integer value from 0 (midnight) to 23 (11:00 PM). Por defeito, o ccmeval corre à meia-noite.By default, ccmeval runs at midnight.

Para obter mais informações sobre a avaliação de saúde do cliente, consulte os clientes Monitor.For more information on client health evaluation, see Monitor clients.

CCMFIRSTCERTCCMFIRSTCERT

Se definir este imóvel 1 para, o cliente seleciona o certificado PKI com o período de validade mais longo.If you set this property to 1, the client selects the PKI certificate with the longest validity period.

Exemplo: CCMSetup.exe /UsePKICert CCMFIRSTCERT=1Example: CCMSetup.exe /UsePKICert CCMFIRSTCERT=1

CCMHOSTNAMECCMHOSTNAME

Se o cliente for gerido através da internet, esta propriedade especifica o FQDN do ponto de gestão baseado na Internet.If the client is managed over the internet, this property specifies the FQDN of the internet-based management point.

Não especifique esta opção com a propriedade de instalação de SMSSITECODE=AUTO.Don't specify this option with the installation property of SMSSITECODE=AUTO. Atribua diretamente clientes baseados na Internet a um site baseado na Internet.Directly assign internet-based clients to an internet-based site.

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

Esta propriedade pode especificar o endereço de um gateway de gestão de nuvem (CMG).This property can specify the address of a cloud management gateway (CMG). Para obter o valor deste imóvel, utilize os seguintes passos:To get the value for this property, use the following steps:

  • Criar um CMG.Create a CMG. Para obter mais informações, consulte Configurar um CMG.For more information, see Set up a CMG.

  • Num cliente ativo, abra um pedido de comando Do Windows PowerShell como administrador.On an active client, open a Windows PowerShell command prompt as an administrator.

  • Execute o seguinte comando:Run the following command:

    (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.Use the returned value as-is with the CCMHOSTNAME property.

Por exemplo: ccmsetup.exe CCMHOSTNAME=CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100For example: 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:// .When you specify the address of a CMG for the CCMHOSTNAME property, don't append a prefix such as https://. Utilize apenas este prefixo com o URL /mp de um CMG.Only use this prefix with the /mp URL of a CMG.

CCMHTTPPORTCCMHTTPPORT

Especifica a porta para o cliente utilizar quando comunica através de HTTP para servidores do sistema de site.Specifies the port for the client to use when it communicates over HTTP to site system servers. Por predefinição, este valor é 80 .By default, this value is 80.

Exemplo: CCMSetup.exe CCMHTTPPORT=80Example: CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORTCCMHTTPSPORT

Especifica a porta para o cliente utilizar quando comunica através do HTTPS para servidores do sistema de site.Specifies the port for the client to use when it communicates over HTTPS to site system servers. Por predefinição, este valor é 443 .By default, this value is 443.

Exemplo: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443Example: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIRCCMINSTALLDIR

Utilize esta propriedade para definir a pasta para instalar os ficheiros do cliente do Gestor de Configuração.Use this property to set the folder to install the Configuration Manager client files. Por predefinição, utiliza %WinDir%\CCM .By default, it uses %WinDir%\CCM.

Dica

Independentemente de onde instalar os ficheiros do cliente, instala sempre o ficheiro ccmcore.dll na %WinDir%\System32 pasta.Regardless of where you install the client files, it always installs the ccmcore.dll file in the %WinDir%\System32 folder. Num sistema operativo de 64 bits, instala uma cópia do ccmcore.dll na %WinDir%\SysWOW64 pasta.On a 64-bit OS, it installs a copy of ccmcore.dll in the %WinDir%\SysWOW64 folder. 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.This file supports 32-bit applications that use the 32-bit version of the client APIs from the Configuration Manager SDK.

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

CCMLOGLEVELCCMLOGLEVEL

Utilize esta propriedade para especificar o nível de detalhe para escrever nos ficheiros de registo do Gestor de Configuração.Use this property to specify the level of detail to write to Configuration Manager log files.

Valores suportados:Supported values:

  • 0: Verbose0: Verbose
  • 1: Predefinição1: Default
  • 2: Advertências e erros2: Warnings and errors
  • 3: Apenas erros3: Errors only

Exemplo: CCMSetup.exe CCMLOGLEVEL=0Example: CCMSetup.exe CCMLOGLEVEL=0

Para obter mais informações, consulte sobre os ficheiros de registo.For more information, see About log files.

CCMLOGMAXHISTORYCCMLOGMAXHISTORY

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.When a Configuration Manager log file reaches the maximum size, the client renames it as a backup and creates a new log file. Esta propriedade especifica quantas versões anteriores do ficheiro de registo para manter.This property specifies how many previous versions of the log file to keep. O valor predefinido é 1.The default value is 1. Se definir o valor 0 para, o cliente não mantém nenhum histórico de registos.If you set the value to 0, the client doesn't keep any log file history.

Exemplo: CCMSetup.exe CCMLOGMAXHISTORY=5Example: CCMSetup.exe CCMLOGMAXHISTORY=5

Para obter mais informações, consulte sobre os ficheiros de registo.For more information, see About log files.

CCMLOGMAXSIZECCMLOGMAXSIZE

Esta propriedade especifica o tamanho máximo do ficheiro de registo em bytes.This property specifies the maximum log file size in bytes. Quando um tronco cresce para o tamanho especificado, o cliente renomea-o como um ficheiro de histórico, e cria um novo.When a log grows to the specified size, the client renames it as a history file, and creates a new one. O tamanho padrão é de 250.000 bytes, e o tamanho mínimo é de 10.000 bytes.The default size is 250,000 bytes, and the minimum size is 10,000 bytes.

Exemplo: CCMSetup.exe CCMLOGMAXSIZE=300000 (300.000 bytes)Example: CCMSetup.exe CCMLOGMAXSIZE=300000 (300,000 bytes)

DISABLESITEOPTDISABLESITEOPT

Desa esta propriedade TRUE para impedir que os administradores mudem o site atribuído no painel de controlo do Gestor de Configuração.Set this property to TRUE to block administrators from changing the assigned site in the Configuration Manager control panel.

Exemplo: CCMSetup.exe DISABLESITEOPT=TRUEExample: CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPTDISABLECACHEOPT

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.If set to TRUE, this property disables the ability of administrative users from changing the client cache folder settings in the Configuration Manager control panel.

Exemplo: CCMSetup.exe DISABLECACHEOPT=TRUEExample: CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIXDNSSUFFIX

Especifique um domínio DNS para que os clientes localizem pontos de gestão que publique no DNS.Specify a DNS domain for clients to locate management points that you publish in DNS. Quando o cliente localiza um ponto de gestão, fala ao cliente sobre outros pontos de gestão na hierarquia.When the client locates a management point, it tells the client about other management points in the hierarchy. Este comportamento significa que o ponto de gestão que o cliente encontra no DNS pode ser qualquer um na hierarquia.This behavior means that the management point that the client finds from DNS can be any one in the hierarchy.

Nota

Não precisa especificar esta propriedade se o cliente estiver no mesmo domínio que um ponto de gestão publicado.You don't have to specify this property if the client is in the same domain as a published management point. Nesse caso, o domínio do cliente é automaticamente utilizado para pesquisar pontos de gestão dns.In that case, the client's domain is automatically used to search DNS for management points.

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.For more information about DNS publishing as a service location method for Configuration Manager clients, see Service location and how clients determine their assigned management point.

Nota

Por predefinição, o Gestor de Configuração não permite a publicação de DNS.By default, Configuration Manager doesn't enable DNS publishing.

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

FSPFSP

Especifique o ponto de estado de retorno que recebe e processa mensagens de estado enviadas pelos clientes do Gestor de Configuração.Specify the fallback status point that receives and processes state messages sent by Configuration Manager clients.

Para obter mais informações, consulte determine se precisa de um ponto de situação de recuo.For more information, see Determine if you need a fallback status point.

Exemplo: CCMSetup.exe FSP=SMSFP01Example: CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECKIGNOREAPPVVERSIONCHECK

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).If you set this property to TRUE, the client installer doesn't check the minimum required version of Microsoft Application Virtualization (App-V).

Importante

Se instalar o cliente Gestor de Configuração sem instalar o App-V, não poderá implementar aplicações virtuais.If you install the Configuration Manager client without installing App-V, you can't deploy virtual applications.

Exemplo: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUEExample: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

NOTIFYONLYNOTIFYONLY

Quando ativa esta propriedade, o cliente reporta o estado, mas não remedia os problemas que encontra.When you enable this property, the client reports status, but doesn't remediate problems that it finds.

Exemplo: CCMSetup.exe NOTIFYONLY=TRUEExample: CCMSetup.exe NOTIFYONLY=TRUE

Para obter mais informações, consulte Como configurar o estado do cliente.For more information, see How to configure client status.

PROVISÕESPROVISIONTS

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.Starting in version 2002, use this property to start a task sequence on a client after it successfully registers with the site.

Por exemplo, você disponibiliza um novo dispositivo Windows 10 com o Windows Autopilot, matricula-o automaticamente no Microsoft Intune e, em seguida, instala o cliente Gestor de Configuração para cogestão.For example, you provision a new Windows 10 device with Windows Autopilot, auto-enroll it to Microsoft Intune, and then install the Configuration Manager client for co-management. Se especificar esta nova opção, o cliente recém-atado executa uma sequência de tarefa.If you specify this new option, the newly provisioned client then runs a task sequence. Este processo dá-lhe flexibilidade adicional para instalar aplicações e atualizações de software, ou configurar definições.This process gives you additional flexibility to install applications and software updates, or configure settings.

Utilize o seguinte processo:Use the following process:

  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.Create a non-OS deployment task sequence to install apps, install software updates, and configure settings.

  2. Implemente esta sequência de tarefas para a nova coleção incorporada, Todos os Dispositivos de Provisionamento.Deploy this task sequence to the new built-in collection, All Provisioning Devices. Note o ID de implementação da sequência de tarefa, por exemplo PRI20001 .Note the task sequence deployment ID, for example PRI20001.

  3. Instale o cliente Gestor de Configuração num dispositivo e inclua a seguinte propriedade: PROVISIONTS=PRI20001 .Install the Configuration Manager client on a device, and include the following property: PROVISIONTS=PRI20001. Desa parte para o valor desta propriedade como iD de implementação da sequência de tarefas.Set the value of this property as the task sequence deployment ID.

    • 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.If you're installing the client from Intune during co-management enrollment, see How to prepare internet-based devices for co-management.

      Nota

      Este método pode ter pré-requisitos adicionais.This method may have additional prerequisites. Por exemplo, inscrever o site no Azure Ative Directory ou criar um portal de gestão de nuvem ativado por conteúdos.For example, enrolling the site to Azure Active Directory, or creating a content-enabled cloud management gateway.

Após a instalação e registos adequados do cliente no site, inicia a sequência de tarefas referenciada.After the client installs and properly registers with the site, it starts the referenced task sequence. Se o registo do cliente falhar, a sequência de tarefas não será iniciada.If client registration fails, the task sequence won't start.

RESETKEYINFORMATIONRESETKEYINFORMATION

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.If a client has the wrong Configuration Manager trusted root key, it can't contact a trusted management point to receive the new trusted root key. Use esta propriedade para remover a velha chave de raiz de confiança.Use this property to remove the old trusted root key. Esta situação pode ocorrer quando se desloca um cliente de uma hierarquia de site para outra.This situation may occur when you move a client from one site hierarchy to another. Esta propriedade aplica-se a clientes que utilizam a comunicação de cliente por HTTP e HTTPS.This property applies to clients that use HTTP and HTTPS client communication. Para obter mais informações, consulte Planeamento para a chave raiz fidedigna.For more information, see Planning for the trusted root key.

Exemplo: CCMSetup.exe RESETKEYINFORMATION=TRUEExample: CCMSetup.exe RESETKEYINFORMATION=TRUE

SITEREASSIGNSITEREASSIGN

Permite a reatribuição automática de sites para atualizações de clientes quando utilizadas com SMSSITECODE=AUTO.Enables automatic site reassignment for client upgrades when used with SMSSITECODE=AUTO.

Exemplo: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUEExample: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE

SMSCACHEDIRSMSCACHEDIR

Especifica a localização da pasta cache do cliente no computador cliente.Specifies the location of the client cache folder on the client computer. Por predefinição, a localização da cache é %WinDir%\ccmcache .By default, the cache location is %WinDir%\ccmcache.

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

Utilize este imóvel com a propriedade SMSCACHEFLAGS para controlar a localização da pasta cache do cliente.Use this property with the SMSCACHEFLAGS property to control the client cache folder location. Por exemplo, instalar a pasta cache do cliente na maior unidade de disco do cliente disponível:CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVEFor example, to install the client cache folder on the largest available client disk drive: CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE

SMSCACHEFLAGSSMSCACHEFLAGS

Utilize esta propriedade para especificar mais detalhes de instalação para a pasta cache do cliente.Use this property to specify further installation details for the client cache folder. Pode utilizar propriedades SMSCACHEFLAGS individualmente ou em combinação separadas por pontos-e-tíricos ; ().You can use SMSCACHEFLAGS properties individually or in combination separated by semicolons (;).

Se você não incluir esta propriedade:If you don't include this property:

  • O cliente instala a pasta cache de acordo com a propriedade SMSCACHEDIRThe client installs the cache folder according to the SMSCACHEDIR property
  • A pasta não é comprimido.The folder isn't compressed
  • O cliente usa a propriedade SMSCACHESIZE como limite de tamanho em MB da cacheThe client uses the SMSCACHESIZE property as the size limit in MB of the cache

Quando atualiza um cliente existente, o instalador do cliente ignora esta propriedade.When you upgrade an existing client, the client installer ignores this property.

Valores para a propriedade SMSCACHEFLAGSValues for the SMSCACHEFLAGS property

  • PERCENTDISKSPACE: Desa ajuste o tamanho da cache em percentagem do espaço total do disco.PERCENTDISKSPACE: Set the cache size as a percentage of the total disk space. Se especificar este imóvel, também definir SMSCACHESIZE para um valor percentual.If you specify this property, also set SMSCACHESIZE to a percentage value.

  • PERCENTFREEDISKSPACE: Desa ajuste o tamanho da cache em percentagem do espaço do disco livre.PERCENTFREEDISKSPACE: Set the cache size as a percentage of the free disk space. Se especificar este imóvel, também definir SMSCACHESIZE como um valor percentual.If you specify this property, also set SMSCACHESIZE as a percentage value. Por exemplo, o disco tem 10 MB grátis e SMSCACHESIZE=50 especifica.For example, the disk has 10 MB free, and you specify SMSCACHESIZE=50. O instalador do cliente define o tamanho da cache para 5 MB.The client installer sets the cache size to 5 MB. Você não pode usar esta propriedade com a propriedade PERCENTDISKSPACE.You can't use this property with the PERCENTDISKSPACE property.

  • MAXDRIVE: Instale a cache no maior disco disponível.MAXDRIVE: Install the cache on the largest available disk. Se especificar um caminho com a propriedade SMSCACHEDIR, o instalador do cliente ignora este valor.If you specify a path with the SMSCACHEDIR property, the client installer ignores this value.

  • MAXDRIVESPACE: Instale a cache na unidade do disco com o espaço mais livre.MAXDRIVESPACE: Install the cache on the disk drive with the most free space. Se especificar um caminho com a propriedade SMSCACHEDIR, o instalador do cliente ignora este valor.If you specify a path with the SMSCACHEDIR property, the client installer ignores this value.

  • NTFSONLY: Instale apenas a cache numa unidade de disco formatada NTFS.NTFSONLY: Only install the cache on an NTFS-formatted disk drive. Se especificar um caminho com a propriedade SMSCACHEDIR, o instalador do cliente ignora este valor.If you specify a path with the SMSCACHEDIR property, the client installer ignores this value.

  • COMPRESS: Guarde a cache de forma comprimido.COMPRESS: Store the cache in a compressed form.

  • FAILIFNOSPACE: Se não houver espaço suficiente para instalar a cache, remova o cliente Gestor de Configuração.FAILIFNOSPACE: If there's insufficient space to install the cache, remove the Configuration Manager client.

Exemplo: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESSExample: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZESMSCACHESIZE

Importante

As definições do cliente estão disponíveis para especificar o tamanho da pasta cache do cliente.Client settings are available for specifying the client cache folder size. 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.The addition of those client settings effectively replaces using SMSCACHESIZE as a client.msi property to specify the size of the client cache. Para obter mais informações, veja as definições do cliente para tamanho da cache.For more information, see the client settings for cache size.

Quando atualiza um cliente existente, o instalador do cliente ignora esta definição.When you upgrade an existing client, the client installer ignores this setting. O cliente também ignora o tamanho da cache quando descarrega atualizações de software.The client also ignores the cache size when it downloads software updates.

Exemplo: CCMSetup.exe SMSCACHESIZE=100Example: 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.If you reinstall a client, you can't use SMSCACHESIZE or SMSCACHEFLAGS to set the cache size to be smaller than it was previously. O tamanho anterior é o valor mínimo.The previous size is the minimum value.

SMSCONFIGSOURCESMSCONFIGSOURCE

Utilize esta propriedade para especificar a localização e encomendar que o instalador do cliente verifique as definições de configuração.Use this property to specify the location and order that the client installer checks for configuration settings. É uma sequência de um ou mais caracteres, cada um definindo uma fonte de configuração específica:It's a string of one or more characters, each defining a specific configuration source:

  • R: Verifique as definições de configuração no registo.R: Check for configuration settings in the registry.

    Para mais informações, consulte as propriedades de instalação do cliente Provision.For more information, see Provision client installation properties.

  • P: Verifique as definições de configuração nas propriedades de instalação da linha de comando.P: Check for configuration settings in the installation properties from the command line.

  • M: Verifique as definições existentes quando atualizar um cliente mais velho.M: Check for existing settings when you upgrade an older client.

  • U: Atualize o cliente instalado para uma versão mais recente e utilize o código do site atribuído.U: Upgrade the installed client to a newer version and use the assigned site code.

Por predefinição, o instalador do cliente utiliza PU .By default, the client installer uses PU. Verifica primeiro as propriedades de instalação P e, em seguida, as definições existentes ( U ).It first checks the installation properties (P) and then the existing settings (U).

Exemplo: CCMSetup.exe SMSCONFIGSOURCE=RPExample: CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMPSMSMP

Especifica um ponto de gestão inicial para o cliente Gestor de Configuração utilizar.Specifies an initial management point for the Configuration Manager client to use.

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:// .If the management point only accepts client connections over HTTPS, prefix the management point name with https://.

Exemplos:Examples:

  • CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSPUBLICROOTKEYSMSPUBLICROOTKEY

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.If the client can't get the Configuration Manager trusted root key from Active Directory Domain Services, use this property to specify the key. Esta propriedade aplica-se aos clientes que utilizam comunicação HTTP e HTTPS.This property applies to clients that use HTTP and HTTPS communication. Para obter mais informações, consulte Planeamento para a chave raiz fidedigna.For more information, see Planning for the trusted root key.

Exemplo: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>Example: 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.Get the value for the site's trusted root key from the mobileclient.tcf file on the site server. Para obter mais informações, consulte pré-fornecimento de um cliente com a chave raiz fidedigna utilizando um ficheiro.For more information, see Pre-provision a client with the trusted root key by using a file.

SMSROOTKEYPATHSMSROOTKEYPATH

Utilize esta propriedade para reinstalar a chave de raiz fidedigna do Gestor de Configuração.Use this property to reinstall the Configuration Manager trusted root key. Especifica o caminho e o nome completos de um ficheiro que contém a chave de raiz fidedigna.It specifies the full path and name of a file that contains the trusted root key. Esta propriedade aplica-se a clientes que utilizam a comunicação de cliente por HTTP e HTTPS.This property applies to clients that use HTTP and HTTPS client communication. Para obter mais informações, consulte Planeamento para a chave raiz fidedigna.For more information, see Planning for the trusted root key.

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

SMSSIGNCERTSMSSIGNCERT

Especifica o caminho e o nome completos do certificado auto-assinado exportado no servidor do site.Specifies the full path and name of the exported self-signed certificate on the site server. O servidor do site armazena este certificado na loja de certificados SMS.The site server stores this certificate in the SMS certificate store. Tem o Servidor do Site do Nome de Assunto e o Certificado de Assinatura do Servidor do Servidor do Sitede nome amigável .It has the Subject name Site Server and the friendly name Site Server Signing Certificate.

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

SMSSITECODESMSSITECODE

Esta propriedade especifica um site do Gestor de Configuração ao qual atribui o cliente.This property specifies a Configuration Manager site to which you assign the client. Este valor pode ser um código de site de três caracteres ou a palavra AUTO .This value can either be a three-character site code or the word 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.If you specify AUTO, or don't specify this property, the client attempts to determine its site assignment from Active Directory Domain Services or from a specified management point. Para ativar AUTO as atualizações do cliente, desatar também SITEREASSIGN=TRUE.To enable AUTO for client upgrades, also set 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.If you also specify an internet-based management point with the CCMHOSTNAME property, don't use AUTO with SMSSITECODE. Atribua diretamente o cliente ao seu site especificando o código do site.Directly assign the client to its site by specifying the site code.

Exemplo: CCMSetup.exe SMSSITECODE=XZYExample: CCMSetup.exe SMSSITECODE=XZY

Valores de atributos para critérios de seleção de certificadosAttribute values for certificate selection criteria

O Gestor de Configuração suporta os seguintes valores de atributos para os critérios de seleção de certificados PKI:Configuration Manager supports the following attribute values for the PKI certificate selection criteria:

Atributo OIDOID attribute Atributo de Nome ÚnicoDistinguished Name attribute Definição do atributoAttribute definition
0.9.2342.19200300.100.1.250.9.2342.19200300.100.1.25 DCDC Componente do domínioDomain component
1.2.840.113549.1.9.11.2.840.113549.1.9.1 E ou E-mailE or E-mail Endereço de e-mailEmail address
2.5.4.32.5.4.3 CNCN Nome comumCommon name
2.5.4.42.5.4.4 SNSN Nome do requerenteSubject name
2.5.4.52.5.4.5 SERIALNUMBERSERIALNUMBER Número de sérieSerial number
2.5.4.62.5.4.6 CC Código de paísCountry code
2.5.4.72.5.4.7 LL LocalidadeLocality
2.5.4.82.5.4.8 S ou STS or ST Nome do estado ou distritoState or province name
2.5.4.92.5.4.9 STREETSTREET MoradaStreet address
2.5.4.102.5.4.10 OO Nome da organizaçãoOrganization name
2.5.4.112.5.4.11 OUOU Unidade organizacionalOrganizational unit
2.5.4.122.5.4.12 T ou TitleT or Title TítuloTitle
2.5.4.422.5.4.42 G ou GN ou GivenNameG or GN or GivenName Nome próprioGiven name
2.5.4.432.5.4.43 I ou InitialsI or Initials IniciaisInitials
2.5.29.172.5.29.17 (sem valor)(no value) Nome Alternativo do RequerenteSubject Alternative Name