Compartilhar via


Criar windowsUpdateForBusinessConfiguration

Namespace: microsoft.graph

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Cria um novo 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

POST /deviceManagement/deviceConfigurations

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 bem-sucedido, este método retornará um código de resposta 201 Created e um objeto windowsUpdateForBusinessConfiguration no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
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 201 Created
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
}