Tipo de recurso windowsUpdateForBusinessConfiguration

  • Artigo

Namespace: microsoft.graph

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

Windows Update para configuração de negócios, permite especificar como e quando o Windows como serviço atualiza seus dispositivos Windows 10/11 com atualizações de recursos e qualidade. Dá suporte a cláusulas ODATA que a entidade DeviceConfiguration dá suporte: $filter por tipos de DeviceConfiguration, $top, $select apenas propriedades base DeviceConfiguration, $orderby apenas propriedades base DeviceConfiguration e $skip. Não há suporte para o parâmetro de consulta '$search'.

Herda de deviceConfiguration

Métodos

Método Tipo de retorno Descrição
Listar windowsUpdateForBusinessConfigurations Coleção windowsUpdateForBusinessConfiguration Lista propriedades e relações dos objetos windowsUpdateForBusinessConfiguration.
Obter windowsUpdateForBusinessConfiguration windowsUpdateForBusinessConfiguration Propriedades de leitura e relações do objeto windowsUpdateForBusinessConfiguration.
Criar windowsUpdateForBusinessConfiguration windowsUpdateForBusinessConfiguration Cria um novo objeto windowsUpdateForBusinessConfiguration.
Excluir windowsUpdateForBusinessConfiguration Nenhum Exclui um windowsUpdateForBusinessConfiguration.
Atualizar windowsUpdateForBusinessConfiguration windowsUpdateForBusinessConfiguration Atualiza as propriedades de um objeto windowsUpdateForBusinessConfiguration.

Propriedades

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 de entrega. Os valores possíveis são: UserDefined, HttpOnly, HttpWithPeeringNat, HttpWithPeeringPrivateGroup, HttpWithInternetPeering, SimpleDownload, BypassMode. UserDefined permite que o usuário defina. Devolvido por padrão. Não há suporte para parâmetros de consulta. Os valores possíveis são: userDefined, httpOnly, httpWithPeeringNat, httpWithPeeringPrivateGroup, httpWithInternetPeering, simpleDownload, bypassMode.
prereleaseFeatures prereleaseFeatures Os recursos de pré-lançamento. Os valores possíveis são: UserDefined, SettingsOnly, SettingsAndExperimentations, NotAllowed. UserDefined é o valor padrão, sem intenção. Devolvido por padrão. Não há suporte para parâmetros de consulta. 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 padrão, sem intenção. Devolvido por padrão. Não há suporte para parâmetros de consulta. Os possíveis valores são: userDefined, notifyDownload, autoInstallAtMaintenanceTime, autoInstallAndRebootAtMaintenanceTime, autoInstallAndRebootAtScheduledTime, autoInstallAndRebootWithoutEndUserControl.
microsoftUpdateServiceAllowed Booliano Quando TRUE, permite o Serviço de Atualização da Microsoft. Quando FALSE, não permite o Serviço de Atualização da Microsoft. Devolvido por padrão. Não há suporte para parâmetros de consulta.
driversExcluded Booliano Quando TRUE, exclui drivers de atualização do Windows. Quando FALSE, não exclui Drivers de atualização do Windows. Devolvido por padrão. Não há suporte para parâmetros de consulta.
installationSchedule windowsUpdateInstallScheduleType O Agendamento de Instalação. Os valores possíveis são: ActiveHoursStart, ActiveHoursEnd, ScheduledInstallDay, ScheduledInstallTime. Devolvido por padrão. Não há suporte para parâmetros de consulta.
qualityUpdatesDeferralPeriodInDays Int32 Adiar o Atualizações de qualidade por esses muitos dias com intervalo válido de 0 a 30 dias. Devolvido por padrão. Não há suporte para parâmetros de consulta.
featureUpdatesDeferralPeriodInDays Int32 Adiar o recurso Atualizações por esses muitos dias com intervalo válido de 0 a 30 dias. Devolvido por padrão. Não há suporte para parâmetros de consulta.
qualityUpdatesPaused Booliano Quando TRUE, os dispositivos atribuídos são pausados para receber atualizações de qualidade por até 35 dias a partir do momento em que você pausa o anel. Quando FALSE, não pausa o Atualizações de qualidade. Devolvido por padrão. Não há suporte para parâmetros de consulta.
featureUpdatesPaused Booliano Quando TRUE, os dispositivos atribuídos são interrompidos de receber atualizações de recursos por até 35 dias a partir do momento em que você pausa o anel. Quando FALSE, não pausa o recurso Atualizações. Devolvido por padrão. Não há suporte para parâmetros de consulta.
qualityUpdatesPauseExpiryDateTime DateTimeOffset O tempo de data de expiração de pausa de Atualizações de qualidade. Esse valor é de 35 dias a partir do momento em que o administrador fez uma pausa ou estendeu a pausa para o anel. Devolvido por padrão. Não há suporte para parâmetros de consulta.
featureUpdatesPauseExpiryDateTime DateTimeOffset O recurso Atualizações pausar o datetime de expiração. Esse valor é de 35 dias a partir do momento em que o administrador fez uma pausa ou estendeu a pausa para o anel. Devolvido por padrão. Não há suporte para parâmetros de consulta.
businessReadyUpdatesOnly windowsUpdateType Determina de qual ramificação os dispositivos receberão suas atualizações. Os valores possíveis são: UserDefined, All, BusinessReadyOnly, WindowsInsiderBuildFast, WindowsInsiderBuildSlow, WindowsInsiderBuildRelease. Devolvido por padrão. Não há suporte para parâmetros de consulta. Os possíveis valores são: userDefined, all, businessReadyOnly, windowsInsiderBuildFast, windowsInsiderBuildSlow, windowsInsiderBuildRelease.
skipChecksBeforeRestart Booliano Quando TRUE, ignora todas as verificações antes de reiniciar: Nível da bateria = 40%, Presença do usuário, Exibição Necessária, Modo de Apresentação, modo de tela inteira, estado da chamada telefônica, modo de jogo etc. Quando FALSE, não ignora todas as verificações antes de reiniciar. Devolvido por padrão. Não há suporte para parâmetros de consulta.
updateWeeks windowsUpdateForBusinessUpdateWeeks Agende a instalação de atualização nas semanas do mês. Os valores possíveis são: UserDefined, FirstWeek, SecondWeek, ThirdWeek, FourthWeek, EveryWeek. Devolvido por padrão. Não há suporte para parâmetros de consulta. Os valores possíveis são: userDefined, firstWeek, secondWeek, thirdWeek, fourthWeek, everyWeek, unknownFutureValue.
qualityUpdatesPauseStartDate Date A data de início do Quality Atualizações Pause. Esse valor é a hora em que o administrador fez uma pausa ou estendeu a pausa para o anel. Devolvido por padrão. Não há suporte para parâmetros de consulta. Essa propriedade é somente leitura.
featureUpdatesPauseStartDate Date A data de início do Recurso Atualizações Pausar. Esse valor é a hora em que o administrador fez uma pausa ou estendeu a pausa para o anel. Devolvido por padrão. Não há suporte para parâmetros de consulta. Essa propriedade é somente leitura.
featureUpdatesRollbackWindowInDays Int32 O número de dias após uma Atualização de Recurso para a qual uma reversão é válida com intervalo válido de 2 a 60 dias. Devolvido por padrão. Não há suporte para parâmetros de consulta.
qualityUpdatesWillBeRolledBack Booliano Quando TRUE, a Atualizações de qualidade de reversão no próximo dispositivo marcar. Quando FALSE, não reverta o Atualizações de qualidade no próximo dispositivo marcar. Devolvido por padrão. Não há suporte para parâmetros de consulta.
featureUpdatesWillBeRolledBack Booliano Quando TRUE, o recurso de reversão Atualizações no próximo dispositivo marcar. Quando FALSE, não reverta o recurso Atualizações no próximo dispositivo marcar. Retornado por padrão. Não há suporte para parâmetros de consulta.
qualityUpdatesRollbackStartDateTime DateTimeOffset A data de início da reversão de Atualizações de qualidade. Esse valor é a hora em que o administrador reverteu a atualização de qualidade do anel. Devolvido por padrão. Não há suporte para parâmetros de consulta.
featureUpdatesRollbackStartDateTime DateTimeOffset O recurso Atualizações data de início da reversão. Esse valor é a hora em que o administrador reverteu a atualização de recurso para o anel. Retornado por padrão. Não há suporte para parâmetros de consulta.
engagedRestartDeadlineInDays Int32 Prazo em dias antes de agendar e executar automaticamente uma reinicialização pendente fora do horário ativo, com intervalo válido de 2 a 30 dias. Devolvido por padrão. Não há suporte para parâmetros de consulta.
engagedRestartSnoozeScheduleInDays Int32 Número de dias em que um usuário pode cochilar notificações de lembrete de reinicialização engajada com intervalo válido de 1 a 3 dias. Devolvido por padrão. Não há suporte para parâmetros de consulta.
engagedRestartTransitionScheduleInDays Int32 Número de dias antes da transição das Reinicializações Automáticas agendadas fora do horário ativo para a Reinicialização Engajada, o que exige que o usuário agende, com intervalo válido de 0 a 30 dias. Devolvido por padrão. Não há suporte para parâmetros de consulta.
deadlineForFeatureUpdatesInDays Int32 Número de dias antes de as atualizações de recursos serem instaladas automaticamente com intervalo válido de 0 a 30 dias. Devolvido por padrão. Não há suporte para parâmetros de consulta.
deadlineForQualityUpdatesInDays Int32 Número de dias antes de as atualizações de qualidade serem instaladas automaticamente com intervalo válido de 0 a 30 dias. Devolvido por padrão. Não há suporte para parâmetros de consulta.
deadlineGracePeriodInDays Int32 O número de dias após o prazo até a reinicialização ocorre automaticamente com intervalo válido de 0 a 7 dias. Devolvido por padrão. Não há suporte para parâmetros de consulta.
postponeRebootUntilAfterDeadline Booliano Quando TRUE, o dispositivo deve aguardar até o prazo final para reinicialização fora do horário ativo. Quando FALSE, o dispositivo não deve aguardar até o prazo final para reinicialização fora do horário ativo. Devolvido por padrão. Não há suporte para parâmetros de consulta.
autoRestartNotificationDismissal autoRestartNotificationDismissalMethod Especifique o método pelo qual a notificação necessária de reinicialização automática é descartada. Os valores possíveis são: Não Configurado, Automático, Usuário. Devolvido por padrão. Não há suporte para parâmetros de consulta. Os valores possíveis são: notConfigured, automatic, user, unknownFutureValue.
scheduleRestartWarningInHours Int32 Especifique o período para notificações de lembrete de reinicialização automática. Valores com suporte: 2, 4, 8, 12 ou 24 (horas). Devolvido por padrão. Não há suporte para parâmetros de consulta.
scheduleImminentRestartWarningInMinutes Int32 Especifique o período para reiniciar automaticamente notificações de aviso iminentes. Valores com suporte: 15, 30 ou 60 (minutos). Devolvido por padrão. Não há suporte para parâmetros de consulta.
userPauseAccess Capacitação Especifica se é necessário habilitar o acesso do usuário final para pausar as atualizações de software. Os valores possíveis são: Não Configurado, Habilitado, Desabilitado. Devolvido por padrão. Não há suporte para parâmetros de consulta. Os valores possíveis são: notConfigured, enabled, disabled.
userWindowsUpdateScanAccess Capacitação Especifica se é necessário desabilitar o acesso do usuário para verificar Windows Update. Os valores possíveis são: Não Configurado, Habilitado, Desabilitado. Devolvido por padrão. Não há suporte para parâmetros de consulta. Os valores possíveis são: notConfigured, enabled, disabled.
updateNotificationLevel windowsUpdateNotificationDisplayOption Especifica quais notificações Windows Update os usuários veem. Os valores possíveis são: NotConfigured, DefaultNotifications, RestartWarningsOnly, DisableAllNotifications. Devolvido por padrão. Não há suporte para parâmetros de consulta. Os valores possíveis são: notConfigured, defaultNotifications, restartWarningsOnly, disableAllNotifications, unknownFutureValue.
allowWindows11Upgrade Booliano Quando TRUE, permite que dispositivos Windows 10 qualificados atualizem para Windows 11. Quando FALSE, implica que o dispositivo permanece no sistema operacional existente. Devolvido por padrão. Não há suporte para parâmetros de consulta.

Relações

Relação Tipo Descrição
assignments Coleção deviceConfigurationAssignment A lista de atribuições para o perfil de configuração do dispositivo. Herdada de deviceConfiguration
deviceStatuses Coleção deviceConfigurationDeviceStatus Status da instalação da configuração de dispositivo por dispositivo. Herdada de deviceConfiguration
userStatuses Coleção deviceConfigurationUserStatus Instalação de configuração do dispositivo status pelo usuário. Herdada de deviceConfiguration
deviceStatusOverview deviceConfigurationDeviceOverview Visão geral de status de dispositivos para Configuração de Dispositivo. Herdado de deviceConfiguration
userStatusOverview deviceConfigurationUserOverview Visão geral de status de usuários para Configuração de Dispositivo. Herdado de deviceConfiguration
deviceSettingStateSummaries Coleção settingStateDeviceSummary Visão geral de dispositivos de configuração para Configuração de Dispositivo. Herdado de deviceConfiguration

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "@odata.type": "#microsoft.graph.windowsUpdateForBusinessConfiguration",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "version": 1024,
  "deliveryOptimizationMode": "String",
  "prereleaseFeatures": "String",
  "automaticUpdateMode": "String",
  "microsoftUpdateServiceAllowed": true,
  "driversExcluded": true,
  "installationSchedule": {
    "@odata.type": "microsoft.graph.windowsUpdateScheduledInstall",
    "scheduledInstallDay": "String",
    "scheduledInstallTime": "String (time of day)"
  },
  "qualityUpdatesDeferralPeriodInDays": 1024,
  "featureUpdatesDeferralPeriodInDays": 1024,
  "qualityUpdatesPaused": true,
  "featureUpdatesPaused": true,
  "qualityUpdatesPauseExpiryDateTime": "String (timestamp)",
  "featureUpdatesPauseExpiryDateTime": "String (timestamp)",
  "businessReadyUpdatesOnly": "String",
  "skipChecksBeforeRestart": true,
  "updateWeeks": "String",
  "qualityUpdatesPauseStartDate": "String (Date)",
  "featureUpdatesPauseStartDate": "String (Date)",
  "featureUpdatesRollbackWindowInDays": 1024,
  "qualityUpdatesWillBeRolledBack": true,
  "featureUpdatesWillBeRolledBack": true,
  "qualityUpdatesRollbackStartDateTime": "String (timestamp)",
  "featureUpdatesRollbackStartDateTime": "String (timestamp)",
  "engagedRestartDeadlineInDays": 1024,
  "engagedRestartSnoozeScheduleInDays": 1024,
  "engagedRestartTransitionScheduleInDays": 1024,
  "deadlineForFeatureUpdatesInDays": 1024,
  "deadlineForQualityUpdatesInDays": 1024,
  "deadlineGracePeriodInDays": 1024,
  "postponeRebootUntilAfterDeadline": true,
  "autoRestartNotificationDismissal": "String",
  "scheduleRestartWarningInHours": 1024,
  "scheduleImminentRestartWarningInMinutes": 1024,
  "userPauseAccess": "String",
  "userWindowsUpdateScanAccess": "String",
  "updateNotificationLevel": "String",
  "allowWindows11Upgrade": true
}