CSP Policy

  • Artigo

O provedor de serviços de configuração de política permite que a empresa configure políticas em Windows 10 e Windows 11. Use esse provedor de serviços de configuração para configurar quaisquer políticas da empresa.

O provedor de serviços de configuração de política tem as seguintes subcategorias:

  • Policy/Config/AreaName – Manipula a solicitação de configuração de política do servidor.
  • Política/Resultado/AreaName – Fornece um caminho somente leitura para políticas impostas no dispositivo.

Escopo da política

O escopo da política é o nível em que uma política pode ser configurada. Algumas políticas só podem ser configuradas no nível do dispositivo, o que significa que a política entrará em vigor independentemente de quem está conectado ao dispositivo. Outras políticas podem ser configuradas no nível do usuário, o que significa que a política só entrará em vigor para esse usuário. Para configurar uma política em um escopo específico (usuário versus dispositivo), use os seguintes caminhos:

Escopo do usuário:

  • ./User/Vendor/MSFT/Policy/Config/AreaName/PolicyName para configurar a política.
  • ./User/Vendor/MSFT/Policy/Result/AreaName/PolicyName para obter o resultado.

Escopo do dispositivo:

  • ./Device/Vendor/MSFT/Policy/Config/AreaName/PolicyName para configurar a política.
  • ./Device/Vendor/MSFT/Policy/Result/AreaName/PolicyName para obter o resultado.

Observação

Para a configuração de todo o dispositivo, o dispositivo/ parte pode ser omitido do caminho, julgando os seguintes caminhos, respectivamente, equivalentes aos caminhos fornecidos acima:

  • ./Vendor/MSFT/Policy/Config/AreaName/PolicyName para configurar a política.
  • ./Vendor/MSFT/Policy/Result/AreaName/PolicyName para obter o resultado.

A lista a seguir mostra os nós do provedor de serviços de configuração de política:

Dispositivo/Configuração

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
✅ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1507 [10.0.10240] e posterior 
./Device/Vendor/MSFT/Policy/Config

Nó para agrupar todas as políticas configuradas por uma fonte. A fonte de configuração pode usar esse caminho para definir valores de política e consultar posteriormente qualquer valor de política definido anteriormente. Uma política pode ser configurada por várias fontes de configuração. Se uma fonte de configuração quiser consultar o resultado da resolução de conflitos (por exemplo, se Exchange e MDM tentarem definir um valor), a fonte de configuração poderá usar o caminho Política/Resultado para recuperar o valor resultante.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Adicionar, Excluir, Obter

Dispositivo/Config/{AreaName}

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
✅ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1507 [10.0.10240] e posterior 
./Device/Vendor/MSFT/Policy/Config/{AreaName}

O grupo de área que pode ser configurado por uma única tecnologia para um único provedor. Depois de adicionado, você não pode alterar o valor. Consulte os DDFs de área individuais para CSP de política para obter uma lista de Áreas que podem ser configuradas.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Adicionar, Excluir, Obter
Nomenclatura de nó dinâmico ClientInventory

Dispositivo/Config/{AreaName}/{PolicyName}

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
✅ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1507 [10.0.10240] e posterior 
./Device/Vendor/MSFT/Policy/Config/{AreaName}/{PolicyName}

Especifica o par nome/valor usado na política. Consulte os DDFs de área individuais para obter mais informações sobre as políticas disponíveis para configurar.

A lista a seguir mostra algumas dicas para ajudá-lo ao configurar políticas:

  • Separar valores de substring por Unicode 0xF000 no arquivo XML.

    Observação

    Uma consulta de um chamador diferente poderia fornecer um valor diferente, pois cada chamador poderia ter valores diferentes para uma política nomeada.

  • Em SyncML, embrulhe essa política com o comando Atomic para que as configurações de política sejam tratadas como uma única transação.
  • As operações com suporte são Adicionar, Obter, Excluir e Substituir.
  • Tipo de valor é cadeia de caracteres.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato null
Tipo de Acesso Adicionar, Excluir, Obter, Substituir
Nomenclatura de nó dinâmico ClientInventory

Dispositivo/ConfigOperations

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
❌ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1507 [10.0.10240] e posterior 
./Device/Vendor/MSFT/Policy/ConfigOperations

O nó raiz para agrupar diferentes operações de configuração.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Adicionar, Excluir, Obter

Dispositivo/ConfigOperations/ADMXInstall

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
❌ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1709 [10.0.16299] e posterior 
./Device/Vendor/MSFT/Policy/ConfigOperations/ADMXInstall

Permite que as configurações de arquivos ADMX para aplicativos Win32 e Ponte de Desktop sejam importadas (ingeridas) pelo dispositivo e processadas em novas políticas ou preferências apoiadas pelo ADMX. Usando o ADMXInstall, você pode adicionar políticas apoiadas pelo ADMX para esses aplicativos Win32 ou Ponte de Desktop que foram adicionados entre versões do sistema operacional. As políticas apoiadas pelo ADMX são ingeridas em seu dispositivo usando o URI do CSP de política: ./Vendor/MSFT/Policy/ConfigOperations/ADMXInstall. Cada política ou preferência apoiada pelo ADMX adicionada recebe uma ID exclusiva. Os arquivos ADMX instalados usando ConfigOperations/ADMXInstall podem ser posteriormente excluídos usando a operação de exclusão de URI. Excluir um arquivo ADMX excluirá o arquivo ADMX do disco, removerá os metadados do hive do registro ADMXdefault e excluirá todas as políticas que foram definidas do arquivo. O servidor MDM também pode excluir todas as políticas do ADMX vinculadas a um aplicativo específico chamando excluir no URI, ./Vendor/MSFT/Policy/ConfigOperations/ADMXInstall/{AppName}.

Para obter mais informações sobre como usar o CSP de política para configurar políticas de aplicativo win32 e Ponte de Desktop, consulte Win32 e Ponte de Desktop configuração de política de aplicativo.

Observação

As configurações OPAX gerenciadas pela Ferramenta de Personalização do Microsoft Office não têm suporte no MDM. Para obter mais informações sobre essa ferramenta, consulte Ferramenta de Personalização do Office.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Adicionar, Excluir, Obter

Dispositivo/ConfigOperations/ADMXInstall/{AppName}

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
❌ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1709 [10.0.16299] e posterior 
./Device/Vendor/MSFT/Policy/ConfigOperations/ADMXInstall/{AppName}

Especifica o nome do aplicativo Win32 ou Ponte de Desktop associado ao arquivo ADMX.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Adicionar, Excluir, Obter
Nomenclatura de nó dinâmico UniqueName: especifica o nome do aplicativo Win32 ou Ponte de Desktop associado ao arquivo ADMX.
Dispositivo/ConfigOperations/ADMXInstall/{AppName}/{SettingsType}
Escopo Edições Sistema operacional aplicável
✅ Dispositivo
❌ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1709 [10.0.16299] e posterior 
./Device/Vendor/MSFT/Policy/ConfigOperations/ADMXInstall/{AppName}/{SettingsType}

Tipo de configuração do aplicativo Win32. Política ou Preferência.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Adicionar, Excluir, Obter
Nomenclatura de nó dinâmico UniqueName: tipo de configuração do aplicativo Win32. Política ou Preferência
Dispositivo/ConfigOperations/ADMXInstall/{AppName}/{SettingsType}/{AdmxFileId}
Escopo Edições Sistema operacional aplicável
✅ Dispositivo
❌ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1709 [10.0.16299] e posterior 
./Device/Vendor/MSFT/Policy/ConfigOperations/ADMXInstall/{AppName}/{SettingsType}/{AdmxFileId}

ID exclusiva do arquivo ADMX.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato chr (cadeia de caracteres)
Tipo de Acesso Adicionar, Excluir, Obter, Substituir
Nomenclatura de nó dinâmico ServerGeneratedUniqueIdentifier
Dispositivo/ConfigOperations/ADMXInstall/{AppName}/Properties
Escopo Edições Sistema operacional aplicável
✅ Dispositivo
❌ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1709 [10.0.16299.1481] e posterior
✅Windows 10, versão 1803 [10.0.17134.1099] e posterior
✅Windows 10, versão 1809 [10.0.17763.832] e posterior
✅Windows 10, versão 1903 [10.0.18362.387] e posterior
✅Windows 10, versão 1909 [10.0.18363] e posterior		 
./Device/Vendor/MSFT/Policy/ConfigOperations/ADMXInstall/{AppName}/Properties

Propriedades do Win32 App ADMX Ingestion.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Adicionar, Excluir, Obter
Dispositivo/ConfigOperations/ADMXInstall/{AppName}/Properties/{SettingsType}
Escopo Edições Sistema operacional aplicável
✅ Dispositivo
❌ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1709 [10.0.16299.1481] e posterior
✅Windows 10, versão 1803 [10.0.17134.1099] e posterior
✅Windows 10, versão 1809 [10.0.17763.832] e posterior
✅Windows 10, versão 1903 [10.0.18362.387] e posterior
✅Windows 10, versão 1909 [10.0.18363] e posterior		 
./Device/Vendor/MSFT/Policy/ConfigOperations/ADMXInstall/{AppName}/Properties/{SettingsType}

Tipo de configuração do aplicativo Win32. Política ou Preferência.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Adicionar, Excluir, Obter
Nomenclatura de nó dinâmico UniqueName: tipo de configuração do aplicativo Win32. Política ou Preferência
Dispositivo/ConfigOperations/ADMXInstall/{AppName}/Properties/{SettingsType}/{AdmxFileId}
Escopo Edições Sistema operacional aplicável
✅ Dispositivo
❌ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1709 [10.0.16299.1481] e posterior
✅Windows 10, versão 1803 [10.0.17134.1099] e posterior
✅Windows 10, versão 1809 [10.0.17763.832] e posterior
✅Windows 10, versão 1903 [10.0.18362.387] e posterior
✅Windows 10, versão 1909 [10.0.18363] e posterior		 
./Device/Vendor/MSFT/Policy/ConfigOperations/ADMXInstall/{AppName}/Properties/{SettingsType}/{AdmxFileId}

ID exclusiva do arquivo ADMX.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Adicionar, Excluir, Obter
Nomenclatura de nó dinâmico ServerGeneratedUniqueIdentifier
Dispositivo/ConfigOperations/ADMXInstall/{AppName}/Properties/{SettingsType}/{AdmxFileId}/Version
Escopo Edições Sistema operacional aplicável
✅ Dispositivo
❌ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1709 [10.0.16299.1481] e posterior
✅Windows 10, versão 1803 [10.0.17134.1099] e posterior
✅Windows 10, versão 1809 [10.0.17763.832] e posterior
✅Windows 10, versão 1903 [10.0.18362.387] e posterior
✅Windows 10, versão 1909 [10.0.18363] e posterior		 
./Device/Vendor/MSFT/Policy/ConfigOperations/ADMXInstall/{AppName}/Properties/{SettingsType}/{AdmxFileId}/Version

Versão do arquivo ADMX. Isso pode ser definido pelo servidor para manter um registro da versão do arquivo ADMX ingerido pelo dispositivo.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato chr (cadeia de caracteres)
Tipo de Acesso Adicionar, Excluir, Obter, Substituir

Dispositivo/Resultado

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
✅ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1507 [10.0.10240] e posterior 
./Device/Vendor/MSFT/Policy/Result

Agrupa as políticas avaliadas de todos os provedores que podem ser configuradas.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Obter

Dispositivo/Resultado/{AreaName}

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
✅ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1507 [10.0.10240] e posterior 
./Device/Vendor/MSFT/Policy/Result/{AreaName}

O grupo de área que pode ser configurado por uma única tecnologia independente dos provedores. Consulte os DDFs de área individuais para CSP de política para obter uma lista de Áreas que podem ser configuradas.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Obter
Nomenclatura de nó dinâmico ClientInventory

Dispositivo/Resultado/{AreaName}/{PolicyName}

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
✅ Usuário		 ✅ Pro
✅ Empresa
✅ Educação
✅ Windows SE		 ✅Windows 10, versão 1507 [10.0.10240] e posterior 
./Device/Vendor/MSFT/Policy/Result/{AreaName}/{PolicyName}

Especifica o par nome/valor usado na política. Consulte os DDFs de área individuais para obter mais informações sobre as políticas disponíveis para configurar.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato null
Tipo de Acesso Obter
Nomenclatura de nó dinâmico ClientInventory

Usuário/Configuração

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
✅ Usuário		 ❌ Pro
❌ Empresa
❌ Educação
❌ Windows SE		 
./User/Vendor/MSFT/Policy/Config

Nó para agrupar todas as políticas configuradas por uma fonte. A fonte de configuração pode usar esse caminho para definir valores de política e consultar posteriormente qualquer valor de política definido anteriormente. Uma política pode ser configurada por várias fontes de configuração. Se uma fonte de configuração quiser consultar o resultado da resolução de conflitos (por exemplo, se Exchange e MDM tentarem definir um valor), a fonte de configuração poderá usar o caminho Política/Resultado para recuperar o valor resultante.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Adicionar, Excluir, Obter

Usuário/Config/{AreaName}

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
✅ Usuário		 ❌ Pro
❌ Empresa
❌ Educação
❌ Windows SE		 
./User/Vendor/MSFT/Policy/Config/{AreaName}

O grupo de área que pode ser configurado por uma única tecnologia para um único provedor. Depois de adicionado, você não pode alterar o valor. Consulte os DDFs de área individuais para CSP de política para obter uma lista de Áreas que podem ser configuradas.

A lista a seguir mostra algumas dicas para ajudá-lo ao configurar políticas:

  • Separar valores de substring por Unicode 0xF000 no arquivo XML.

    Observação

    Uma consulta de um chamador diferente poderia fornecer um valor diferente, pois cada chamador poderia ter valores diferentes para uma política nomeada.

  • Em SyncML, embrulhe essa política com o comando Atomic para que as configurações de política sejam tratadas como uma única transação.
  • As operações com suporte são Adicionar, Obter, Excluir e Substituir.
  • Tipo de valor é cadeia de caracteres.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Adicionar, Excluir, Obter
Nomenclatura de nó dinâmico ClientInventory

Usuário/Config/{AreaName}/{PolicyName}

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
✅ Usuário		 ❌ Pro
❌ Empresa
❌ Educação
❌ Windows SE		 
./User/Vendor/MSFT/Policy/Config/{AreaName}/{PolicyName}

Especifica o par nome/valor usado na política. Consulte os DDFs de área individuais para obter mais informações sobre as políticas disponíveis para configurar.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato null
Tipo de Acesso Adicionar, Excluir, Obter, Substituir
Nomenclatura de nó dinâmico ClientInventory

Usuário/Resultado

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
✅ Usuário		 ❌ Pro
❌ Empresa
❌ Educação
❌ Windows SE		 
./User/Vendor/MSFT/Policy/Result

Agrupa as políticas avaliadas de todos os provedores que podem ser configuradas.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Obter

Usuário/Resultado/{AreaName}

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
✅ Usuário		 ❌ Pro
❌ Empresa
❌ Educação
❌ Windows SE		 
./User/Vendor/MSFT/Policy/Result/{AreaName}

O grupo de área que pode ser configurado por uma única tecnologia independente dos provedores. Consulte os DDFs de área individuais para CSP de política para obter uma lista de Áreas que podem ser configuradas.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato node
Tipo de Acesso Obter
Nomenclatura de nó dinâmico ClientInventory

Usuário/Resultado/{AreaName}/{PolicyName}

Escopo Edições Sistema operacional aplicável
✅ Dispositivo
✅ Usuário		 ❌ Pro
❌ Empresa
❌ Educação
❌ Windows SE		 
./User/Vendor/MSFT/Policy/Result/{AreaName}/{PolicyName}

Especifica o par nome/valor usado na política. Consulte os DDFs de área individuais para obter mais informações sobre as políticas disponíveis para configurar.

Propriedades da estrutura de descrição:

Nome da propriedade Valor da propriedade
Formato null
Tipo de Acesso Obter
Nomenclatura de nó dinâmico ServerGeneratedUniqueIdentifier

Áreas de Política

Referência de provedor de serviços de configuração