Atualizar windowsUpdateForBusinessConfiguration
Namespace: microsoft.graph
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Atualizar as propriedades de um objeto windowsUpdateForBusinessConfiguration.
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.
Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
---|---|
Delegado (conta corporativa ou de estudante) | DeviceManagementConfiguration.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Application | DeviceManagementConfiguration.ReadWrite.All |
Solicitação HTTP
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
Cabeçalhos de solicitação
Cabeçalho | Valor |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Aceitar | application/json |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON do objeto windowsUpdateForBusinessConfiguration.
A tabela a seguir mostra as propriedades que são necessárias ao criar windowsUpdateForBusinessConfiguration.
Propriedade | Tipo | Descrição |
---|---|---|
id | String | Chave da entidade. Herdada de deviceConfiguration |
lastModifiedDateTime | DateTimeOffset | DateTime da última modificação do objeto. Herdada de deviceConfiguration |
createdDateTime | DateTimeOffset | DateTime em que o objeto foi criado. Herdada de deviceConfiguration |
description | String | O administrador forneceu a descrição da Configuração do dispositivo. Herdada de deviceConfiguration |
displayName | String | O administrador forneceu o nome da Configuração do dispositivo. Herdada de deviceConfiguration |
versão | Int32 | Versão da configuração do dispositivo. Herdada de deviceConfiguration |
deliveryOptimizationMode | windowsDeliveryOptimizationMode | O Modo de Otimização da Entrega. Os valores possíveis são: UserDefined, HttpOnly, HttpWithPeeringNat, HttpWithPeeringPrivateGroup, HttpWithInternetPeering, SimpleDownload, BypassMode. UserDefined permite que o utilizador defina. Devolvido por padrão. Os parâmetros de consulta não são suportados. Os valores possíveis são: userDefined , httpOnly , httpWithPeeringNat , httpWithPeeringPrivateGroup , httpWithInternetPeering , simpleDownload , bypassMode . |
prereleaseFeatures | prereleaseFeatures | As funcionalidades de pré-lançamento. Os valores possíveis são: UserDefined, SettingsOnly, SettingsAndExperimentations, NotAllowed. UserDefined é o valor predefinido, sem intenção. Devolvido por padrão. Os parâmetros de consulta não são suportados. Os valores possíveis são: userDefined , settingsOnly , settingsAndExperimentations , notAllowed . |
automaticUpdateMode | automaticUpdateMode | O Modo de Atualização Automática. Os valores possíveis são: UserDefined, NotifyDownload, AutoInstallAtMaintenanceTime, AutoInstallAndRebootAtMaintenanceTime, AutoInstallAndRebootAtScheduledTime, AutoInstallAndRebootWithoutEndUserControl, WindowsDefault. UserDefined é o valor predefinido, sem intenção. Devolvido por padrão. Os parâmetros de consulta não são suportados. Os possíveis valores são: userDefined , notifyDownload , autoInstallAtMaintenanceTime , autoInstallAndRebootAtMaintenanceTime , autoInstallAndRebootAtScheduledTime , autoInstallAndRebootWithoutEndUserControl . |
microsoftUpdateServiceAllowed | Booliano | Quando VERDADEIRO, permite o Serviço Microsoft Update. Quando FALSO, não permite o Serviço Microsoft Update. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
driversExcluded | Booliano | Quando VERDADEIRO, exclui os Controladores de Atualização do Windows. Quando falso, não exclui controladores de atualização do Windows. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
installationSchedule | windowsUpdateInstallScheduleType | A Agenda de Instalação. Os valores possíveis são: ActiveHoursStart, ActiveHoursEnd, ScheduledInstallDay, ScheduledInstallTime. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
qualityUpdatesDeferralPeriodInDays | Int32 | Diferir qualidade Atualizações por estes dias com intervalo válido de 0 a 30 dias. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
featureUpdatesDeferralPeriodInDays | Int32 | Diferir Funcionalidade Atualizações por estes dias com intervalo válido de 0 a 30 dias. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
qualityUpdatesPaused | Booliano | Quando VERDADEIRO, os dispositivos atribuídos são colocados em pausa após receberem atualizações de qualidade até 35 dias a partir do momento em que colocar o anel em pausa. Quando FALSO, não coloca em pausa Atualizações de Qualidade. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
featureUpdatesPaused | Booliano | Quando VERDADEIRO, os dispositivos atribuídos são colocados em pausa para receber atualizações de funcionalidades até 35 dias a partir do momento em que colocar o anel em pausa. Quando FALSO, não coloca em pausa a funcionalidade Atualizações. Devolvido por padrão. Os parâmetros de consulta não são suportados.s |
qualityUpdatesPauseExpiryDateTime | DateTimeOffset | O tempo de data de expiração da Atualizações qualidade. Este valor é 35 dias a partir do momento em que o administrador fez uma pausa ou estendeu a pausa para a cadência. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
featureUpdatesPauseExpiryDateTime | DateTimeOffset | A funcionalidade Atualizações colocar em pausa o datetime de expiração. Este valor é 35 dias a partir do momento em que o administrador fez uma pausa ou estendeu a pausa para a cadência. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
businessReadyUpdatesOnly | windowsUpdateType | Determina a partir de que dispositivos de ramo receberão as atualizações. Os valores possíveis são: UserDefined, All, BusinessReadyOnly, WindowsInsiderBuildFast, WindowsInsiderBuildSlow, WindowsInsiderBuildRelease. Devolvido por padrão. Os parâmetros de consulta não são suportados. Os possíveis valores são: userDefined , all , businessReadyOnly , windowsInsiderBuildFast , windowsInsiderBuildSlow , windowsInsiderBuildRelease . |
skipChecksBeforeRestart | Booliano | Quando VERDADEIRO, ignora todas as verificações antes do reinício: Nível da bateria = 40%, Presença do utilizador, Ecrã Necessário, Modo de apresentação, Modo de ecrã inteiro, estado da chamada telefónica, modo de jogo, etc. Quando falso, não ignora todas as verificações antes de reiniciar. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
updateWeeks | windowsUpdateForBusinessUpdateWeeks | Agende a instalação da atualização nas semanas do mês. Os valores possíveis são: UserDefined, FirstWeek, SecondWeek, ThirdWeek, FourthWeek, EveryWeek. Devolvido por padrão. Os parâmetros de consulta não são suportados. Os valores possíveis são: userDefined , firstWeek , secondWeek , thirdWeek , fourthWeek , everyWeek , unknownFutureValue . |
qualityUpdatesPauseStartDate | Data | A data de início de Pausa Atualizações Qualidade. Este valor é a hora em que o administrador fez uma pausa ou estendeu a pausa para o anel. Devolvido por padrão. Os parâmetros de consulta não são suportados. Essa propriedade é somente leitura. |
featureUpdatesPauseStartDate | Data | A funcionalidade Atualizações Colocar em pausa a data de início. Este valor é a hora em que o administrador fez uma pausa ou estendeu a pausa para o anel. Devolvido por padrão. Os parâmetros de consulta não são suportados. Essa propriedade é somente leitura. |
featureUpdatesRollbackWindowInDays | Int32 | O número de dias após uma Atualização de Funcionalidades para a qual uma reversão é válida com intervalo válido de 2 a 60 dias. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
qualityUpdatesWillBeRolledBack | Booliano | Quando VERDADEIRO, reverta a Atualizações de Qualidade no dispositivo seguinte marcar. Quando for FALSO, não reverta a Atualizações de Qualidade no dispositivo seguinte marcar. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
featureUpdatesWillBeRolledBack | Booliano | Quando FOR VERDADEIRO, a Atualizações de Funcionalidades no próximo dispositivo marcar. Quando for FALSO, não reverta a funcionalidade Atualizações no próximo dispositivo marcar no. Devolvido por predefinição. Os parâmetros de consulta não são suportados. |
qualityUpdatesRollbackStartDateTime | DateTimeOffset | Data e hora de Início da Reversão do Atualizações de Qualidade. Este valor é a hora em que o administrador reverte a atualização de Qualidade da cadência. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
featureUpdatesRollbackStartDateTime | DateTimeOffset | A funcionalidade Atualizações Rollback Start datetime. Este valor é a hora em que o administrador reverte a Atualização de funcionalidades da cadência. Devolvido por predefinição. Os parâmetros de consulta não são suportados. |
engagedRestartDeadlineInDays | Int32 | Prazo em dias antes de agendar e executar automaticamente um reinício pendente fora das horas de atividade, com intervalo válido de 2 a 30 dias. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
engagedRestartSnoozeScheduleInDays | Int32 | Número de dias em que um utilizador pode suspender notificações de lembretes de Reinício Envolvido com intervalo válido de 1 a 3 dias. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
engagedRestartTransitionScheduleInDays | Int32 | Número de dias antes da transição dos Reinícios Automáticos agendados fora das horas de atividade para o Reinício Ativo, o que requer que o utilizador agende, com um intervalo válido de 0 a 30 dias. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
deadlineForFeatureUpdatesInDays | Int32 | Número de dias antes de as atualizações de funcionalidades serem instaladas automaticamente com um intervalo válido de 0 a 30 dias. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
deadlineForQualityUpdatesInDays | Int32 | Número de dias antes de as atualizações de qualidade serem instaladas automaticamente com um intervalo válido de 0 a 30 dias. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
deadlineGracePeriodInDays | Int32 | Número de dias após o prazo até que os reinícios ocorram automaticamente com um intervalo válido de 0 a 7 dias. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
postponeRebootUntilAfterDeadline | Booliano | Quando VERDADEIRO, o dispositivo deve aguardar até ao prazo para reiniciar fora das horas de atividade. Quando FALSO, o dispositivo não deve aguardar até ao prazo para reiniciar fora das horas de atividade. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
autoRestartNotificationDismissal | autoRestartNotificationDismissalMethod | Especifique o método através do qual a notificação necessária de reinício automático é dispensada. Os valores possíveis são: NotConfigured, Automatic, User. Devolvido por padrão. Os parâmetros de consulta não são suportados. Os valores possíveis são: notConfigured , automatic , user , unknownFutureValue . |
scheduleRestartWarningInHours | Int32 | Especifique o período para notificações de lembrete de aviso de reinício automático. Valores suportados: 2, 4, 8, 12 ou 24 (horas). Devolvido por padrão. Os parâmetros de consulta não são suportados. |
scheduleImminentRestartWarningInMinutes | Int32 | Especifique o período de reinício automático de notificações de aviso iminentes. Valores suportados: 15, 30 ou 60 (minutos). Devolvido por padrão. Os parâmetros de consulta não são suportados. |
userPauseAccess | ativação | Especifica se pretende ativar o acesso do utilizador final para colocar as atualizações de software em pausa. Os valores possíveis são: Não Configurado, Ativado, Desativado. Devolvido por padrão. Os parâmetros de consulta não são suportados. Os valores possíveis são: notConfigured , enabled , disabled . |
userWindowsUpdateScanAccess | ativação | Especifica se pretende desativar o acesso do utilizador para analisar Windows Update. Os valores possíveis são: Não Configurado, Ativado, Desativado. Devolvido por padrão. Os parâmetros de consulta não são suportados. Os valores possíveis são: notConfigured , enabled , disabled . |
updateNotificationLevel | windowsUpdateNotificationDisplayOption | Especifica o que os utilizadores Windows Update notificações veem. Os valores possíveis são: NotConfigured, DefaultNotifications, RestartWarningsOnly, DisableAllNotifications. Devolvido por padrão. Os parâmetros de consulta não são suportados. Os valores possíveis são: notConfigured , defaultNotifications , restartWarningsOnly , disableAllNotifications , unknownFutureValue . |
allowWindows11Atualizar | Booliano | Quando VERDADEIRO, permite que os dispositivos Windows 10 elegíveis atualizem para Windows 11. Quando FALSO, implica que o dispositivo permanece no sistema operativo existente. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
Resposta
Se tiver êxito, este método retornará um código de resposta 200 OK
e um objeto windowsUpdateForBusinessConfiguration atualizado no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 1963
{
"@odata.type": "#microsoft.graph.windowsUpdateForBusinessConfiguration",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"deliveryOptimizationMode": "httpOnly",
"prereleaseFeatures": "settingsOnly",
"automaticUpdateMode": "notifyDownload",
"microsoftUpdateServiceAllowed": true,
"driversExcluded": true,
"installationSchedule": {
"@odata.type": "microsoft.graph.windowsUpdateScheduledInstall",
"scheduledInstallDay": "everyday",
"scheduledInstallTime": "11:59:31.3170000"
},
"qualityUpdatesDeferralPeriodInDays": 2,
"featureUpdatesDeferralPeriodInDays": 2,
"qualityUpdatesPaused": true,
"featureUpdatesPaused": true,
"qualityUpdatesPauseExpiryDateTime": "2017-01-01T00:00:22.9594683-08:00",
"featureUpdatesPauseExpiryDateTime": "2016-12-31T23:58:08.068669-08:00",
"businessReadyUpdatesOnly": "all",
"skipChecksBeforeRestart": true,
"updateWeeks": "firstWeek",
"qualityUpdatesPauseStartDate": "2016-12-31",
"featureUpdatesPauseStartDate": "2016-12-31",
"featureUpdatesRollbackWindowInDays": 2,
"qualityUpdatesWillBeRolledBack": true,
"featureUpdatesWillBeRolledBack": true,
"qualityUpdatesRollbackStartDateTime": "2016-12-31T23:57:01.05526-08:00",
"featureUpdatesRollbackStartDateTime": "2017-01-01T00:03:21.6080517-08:00",
"engagedRestartDeadlineInDays": 12,
"engagedRestartSnoozeScheduleInDays": 2,
"engagedRestartTransitionScheduleInDays": 6,
"deadlineForFeatureUpdatesInDays": 15,
"deadlineForQualityUpdatesInDays": 15,
"deadlineGracePeriodInDays": 9,
"postponeRebootUntilAfterDeadline": true,
"autoRestartNotificationDismissal": "automatic",
"scheduleRestartWarningInHours": 13,
"scheduleImminentRestartWarningInMinutes": 7,
"userPauseAccess": "enabled",
"userWindowsUpdateScanAccess": "enabled",
"updateNotificationLevel": "defaultNotifications",
"allowWindows11Upgrade": true
}
Resposta
Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2135
{
"@odata.type": "#microsoft.graph.windowsUpdateForBusinessConfiguration",
"id": "4928dd6a-dd6a-4928-6add-28496add2849",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"deliveryOptimizationMode": "httpOnly",
"prereleaseFeatures": "settingsOnly",
"automaticUpdateMode": "notifyDownload",
"microsoftUpdateServiceAllowed": true,
"driversExcluded": true,
"installationSchedule": {
"@odata.type": "microsoft.graph.windowsUpdateScheduledInstall",
"scheduledInstallDay": "everyday",
"scheduledInstallTime": "11:59:31.3170000"
},
"qualityUpdatesDeferralPeriodInDays": 2,
"featureUpdatesDeferralPeriodInDays": 2,
"qualityUpdatesPaused": true,
"featureUpdatesPaused": true,
"qualityUpdatesPauseExpiryDateTime": "2017-01-01T00:00:22.9594683-08:00",
"featureUpdatesPauseExpiryDateTime": "2016-12-31T23:58:08.068669-08:00",
"businessReadyUpdatesOnly": "all",
"skipChecksBeforeRestart": true,
"updateWeeks": "firstWeek",
"qualityUpdatesPauseStartDate": "2016-12-31",
"featureUpdatesPauseStartDate": "2016-12-31",
"featureUpdatesRollbackWindowInDays": 2,
"qualityUpdatesWillBeRolledBack": true,
"featureUpdatesWillBeRolledBack": true,
"qualityUpdatesRollbackStartDateTime": "2016-12-31T23:57:01.05526-08:00",
"featureUpdatesRollbackStartDateTime": "2017-01-01T00:03:21.6080517-08:00",
"engagedRestartDeadlineInDays": 12,
"engagedRestartSnoozeScheduleInDays": 2,
"engagedRestartTransitionScheduleInDays": 6,
"deadlineForFeatureUpdatesInDays": 15,
"deadlineForQualityUpdatesInDays": 15,
"deadlineGracePeriodInDays": 9,
"postponeRebootUntilAfterDeadline": true,
"autoRestartNotificationDismissal": "automatic",
"scheduleRestartWarningInHours": 13,
"scheduleImminentRestartWarningInMinutes": 7,
"userPauseAccess": "enabled",
"userWindowsUpdateScanAccess": "enabled",
"updateNotificationLevel": "defaultNotifications",
"allowWindows11Upgrade": true
}