Compartilhar via


CSP Update

O provedor de serviços de configuração de atualização permite que os administradores de TI gerenciem e controlem a distribuição de novas atualizações.

A tabela abaixo mostra a aplicabilidade do Windows:

Edição Windows 10 Windows 11
Home Sim Sim
Pro Sim Sim
Windows SE Não Sim
Negócios Sim Sim
Enterprise Sim Sim
Educação Sim Sim

Observação

A funcionalidade CSP de atualização de 'ApprovedUpdates' não é recomendada para o gerenciamento de dispositivos de área de trabalho. Para gerenciar atualizações para dispositivos de área de trabalho de Windows Update, consulte a documentação de política CSP - Atualizações para as políticas recomendadas.

O exemplo a seguir mostra o provedor de serviços de configuração de atualização no formato de árvore.

./Vendor/MSFT/Update
----ApprovedUpdates
--------Approved Update Guid
------------ApprovedTime
----FailedUpdates
--------Failed Update Guid
------------HResult
------------State
------------RevisionNumber
----InstalledUpdates
--------Installed Update Guid
------------RevisionNumber
----InstallableUpdates
--------Installable Update Guid
------------Type
------------RevisionNumber
----PendingRebootUpdates
--------Pending Reboot Update Guid
------------InstalledTime
------------RevisionNumber
----LastSuccessfulScanTime
----DeferUpgrade
----Rollback
--------QualityUpdate
--------FeatureUpdate
--------QualityUpdateStatus
--------FeatureUpdateStatus

./Vendor/MSFT/Update O nó raiz.

A operação com suporte é Get.

ApprovedUpdates Nó para aprovações de atualização e aceitação do EULA em nome do usuário final.

Observação

Quando a política RequireUpdateApproval for definida, o MDM usará a lista ApprovedUpdates para passar os GUIDs aprovados. Esses GUIDs devem ser um subconjunto da lista InstallableUpdates.

O MDM deve primeiro apresentar o EULA para ele e aceitá-lo antes que a atualização seja aprovada. Deixar de fazer isso é uma violação de obrigações legais ou contratuais. Os EULAs podem ser obtidos a partir dos metadados de atualização e ter sua própria ID de EULA. É possível que várias atualizações compartilhem o mesmo EULA. Só é necessário aprovar o EULA uma vez por ID do EULA, não um por atualização.

A lista de aprovação de atualização permite que a TI aprove atualizações individuais e classificações de atualização. A aprovação automática por classificações de atualização permite que a TI aprove automaticamente as Atualizações de Definição (ou seja, atualizações das definições de vírus e spyware nos dispositivos) e as Atualizações de Segurança (ou seja, atualizações específicas do produto para vulnerabilidade relacionada à segurança). A lista de aprovação de atualização não dá suporte à desinstalação de atualizações revogando a aprovação de atualizações já instaladas. As atualizações são aprovadas com base em UpdateID e o UpdateID só precisa ser aprovado uma vez. Atualização UpdateID e RevisionNumber fazem parte do tipo UpdateIdentity. Um UpdateID pode ser associado a vários UpdateIdentity GUIDs devido a alterações na configuração RevisionNumber. Os serviços de MDM devem sincronizar o UpdateIdentity de um UpdateID com base na versão mais recente do RevisionNumber para obter os metadados mais recentes para uma atualização. No entanto, a aprovação da atualização é baseada no UpdateID.

Observação

Para a compilação do Windows 10, o cliente poderá precisar reinicializar após a adição das atualizações adicionais.

As operações com suporte são Get e Add.

Guia de atualização aprovadoUpdates/Aprovado Especifica o GUID de atualização.

Para aprovar automaticamente uma classe de atualizações, você pode especificar os GUIDs de Classificações de atualização. É altamente recomendável especificar sempre a classificação de DefinitionsUpdates (E0789628-CE08-4437-BE74-2495B842F43B), que são usadas para assinaturas antimalware. Esses GUIDs são lançados periodicamente (várias vezes por dia). Algumas empresas também podem querer aprovar automaticamente as atualizações de segurança para fazer com que elas sejam implantadas rapidamente.

As operações com suporte são Get e Add.

Exemplo de SyncML:

<LocURI>./Vendor/MSFT/Update/ApprovedUpdates/%7ba317dafe-baf4-453f-b232-a7075efae36e%7d</LocURI>

ApprovedUpdates/Approved Update Guid/ApprovedTime Especifica a hora em que a atualização é aprovada.

As operações com suporte são Get e Add.

FailedUpdates Especifica as atualizações aprovadas que não foram instaladas em um dispositivo.

A operação com suporte é Get.

Guia de Atualização com FalhaUpdates/Falha Atualizar o campo identificador do GUID updateIdentity que representa uma atualização que não foi baixada ou instalada.

A operação com suporte é Get.

FailedUpdates/Failed Update Guid/HResult O código de erro de falha de atualização.

A operação com suporte é Get.

FailedUpdates/Failed Update Guid/State Especifica o estado de atualização com falha.

Atualizar Status Valor inteiro
UpdateStatusNewUpdate 1
UpdateStatusReadyToDownload 2
UpdateStatusDownloading 4
UpdateStatusDownloadBlocked 8
UpdateStatusDownloadFailed 16
UpdateStatusReadyToInstall 32
UpdateStatusInstalling 64
UpdateStatusInstallBlocked 128
UpdateStatusInstallFailed 256
UpdateStatusRebootRequired 512
UpdateStatusUpdateCompleted 1024
UpdateStatusCommitFailed 2048
UpdateStatusPostReboot 4096

A operação com suporte é Get.

FailedUpdates/Failed Update Guid/RevisionNumber Adicionado em Windows 10, versão 1703. O número de revisão da atualização que deve ser passada no servidor para a sincronização do servidor para obter os metadados da atualização.

A operação com suporte é Get.

InstalledUpdates As atualizações instaladas no dispositivo.

A operação com suporte é Get.

Guia de atualização instaladoUpdates/Instalado UpdateIDs que representam as atualizações instaladas em um dispositivo.

A operação com suporte é Get.

InstalledUpdates/Installed Update Guid/RevisionNumber Adicionado em Windows 10, versão 1703. O número de revisão da atualização que deve ser passada no servidor para a sincronização do servidor para obter os metadados da atualização.

A operação com suporte é Get.

InstallableUpdates As atualizações aplicáveis e ainda não instaladas no dispositivo. Essas atualizações incluem atualizações que ainda não foram aprovadas.

A operação com suporte é Get.

Guia de atualização installableUpdates/Installable Atualize os identificadores que representam as atualizações aplicáveis e não instaladas em um dispositivo.

A operação com suporte é Get.

InstallableUpdates/Installable Update Guid/Type O valor updateClassification da atualização. Os valores válidos são:

  • 0 - Nenhum
  • 1 - Segurança
  • 2 – Crítico

A operação com suporte é Get.

InstallableUpdates/Installable Update Guid/RevisionNumber O número de revisão da atualização que deve ser passada no servidor para a sincronização do servidor para obter os metadados da atualização.

A operação com suporte é Get.

PendingRebootUpdates As atualizações que exigem uma reinicialização para concluir a sessão de atualização.

A operação com suporte é Get.

Guia pendingRebootUpdates/Pending Reboot Update Guid Atualize os identificadores para o estado de reinicialização pendente.

A operação com suporte é Get.

PendingRebootUpdates/Pending Reboot Update Guid/InstalledTime A hora em que a atualização é instalada.

A operação com suporte é Get.

PendingRebootUpdates/Pending Reboot Update Guid/RevisionNumber Adicionado em Windows 10, versão 1703. O número de revisão da atualização que deve ser passada no servidor para a sincronização do servidor para obter os metadados da atualização.

A operação com suporte é Get.

LastSuccessfulScanTime O último tempo de verificação bem-sucedido.

A operação com suporte é Get.

DeferUpgrade Atualizações adiadas até o próximo período.

A operação com suporte é Get.

Reversão Adicionado no Windows 10, versão 1803. Nó para as operações de reversão.

Reversão/QualityUpdate Adicionado no Windows 10, versão 1803. Reverta a atualização de qualidade mais recente, se o computador atender às seguintes condições:

  • Condição 1: o dispositivo deve ser Windows Update para o Business Connected
  • Condição 2: o dispositivo deve estar em um estado pausado
  • Condição 3: o dispositivo deve ter a atualização de qualidade mais recente instalada no dispositivo (estado atual)

Se as condições não forem verdadeiras, o dispositivo não reverterá a atualização de qualidade mais recente.

Reversão/FeatureUpdate Adicionado no Windows 10, versão 1803. Reverter a atualização de recursos mais recente, se o computador atender às seguintes condições:

  • Condição 1: o dispositivo deve ser Windows Update para o Business Connected
  • Condição 2: o dispositivo deve estar em estado pausado
  • Condição 3: o dispositivo deve ter a atualização de recursos mais recente instalada no dispositivo (estado atual)
  • Condição 4: o computador deve estar dentro do período de desinstalação

Observação

Isso só funciona para dispositivos de destino do Canal de Disponibilidade Geral.

Se as condições não forem verdadeiras, o dispositivo não reverterá a atualização de recursos mais recente.

Reversão/QualityUpdateStatus Adicionado no Windows 10, versão 1803. Retorna o resultado da última operação RollBack QualityUpdate.

Reversão/FeatureUpdateStatus Adicionado no Windows 10, versão 1803. Retorna o resultado da última operação RollBack FeatureUpdate.

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