Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
A configuração do Windows Update para empresas 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 suporta: $filter por tipos de DeviceConfiguration, $top, $select apenas propriedades de base DeviceConfiguration, $orderby apenas propriedades de 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 valores possíveis são: userDefined, notifyDownload, autoInstallAtMaintenanceTime, autoInstallAndRebootAtMaintenanceTime, autoInstallAndRebootAtScheduledTime, autoInstallAndRebootWithoutEndUserControl. |
| microsoftUpdateServiceAllowed | Booliano | Quando TRUE, permite o Microsoft Update Service. Quando FALSE, não permite o serviço Microsoft Update. Devolvido por padrão. Não há suporte para parâmetros de consulta. |
| driversExcluded | Booliano | Quando TRUE, exclui drivers do Windows Update. Quando FALSE, não exclui os drivers do Windows Update. Devolvido por padrão. Não há suporte para parâmetros de consulta. |
| installationSchedule | windowsUpdateInstallScheduleType | A Agenda 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 as Atualizações de Qualidade por esses muitos dias com um intervalo válido de 0 a 30 dias. Devolvido por padrão. Não há suporte para parâmetros de consulta. |
| featureUpdatesDeferralPeriodInDays | Int32 | Adiar as Atualizações de Recursos por esses muitos dias com um 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 toque. Quando FALSE, não pausa as 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 pausados para receber atualizações de recursos por até 35 dias a partir do momento em que você pausa o toque. Quando FALSE, não pausa as Atualizações de Recursos. Devolvido por padrão. Não há suporte para parâmetros de consulta.s |
| qualityUpdatesPauseExpiryDateTime | DateTimeOffset | A data e hora de expiração da pausa das Atualizações de Qualidade. Esse valor é de 35 dias a partir do momento em que o administrador pausou ou estendeu a pausa para o toque. Devolvido por padrão. Não há suporte para parâmetros de consulta. |
| featureUpdatesPauseExpiryDateTime | DateTimeOffset | As Atualizações de Recursos Pausam a data e hora da expiração. Esse valor é de 35 dias a partir do momento em que o administrador pausou ou estendeu a pausa para o toque. Devolvido por padrão. Não há suporte para parâmetros de consulta. |
| businessReadyUpdatesOnly | windowsUpdateType | Determina de quais dispositivos de filial 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 valores possíveis são: userDefined, all, businessReadyOnly, windowsInsiderBuildFast, windowsInsiderBuildSlow, windowsInsiderBuildRelease. |
| skipChecksBeforeRestart | Booliano | Quando TRUE, pula todas as verificações antes da reinicialização: Nível de 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 da reinicialização. Devolvido por padrão. Não há suporte para parâmetros de consulta. |
| 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. Não há suporte para parâmetros de consulta. Os valores possíveis são userDefined, firstWeek, secondWeek, thirdWeek, fourthWeek, everyWeek, unknownFutureValue. |
| qualityUpdatesPauseStartDate | Data | A data de início da pausa das Atualizações de Qualidade. Esse valor é o momento em que o administrador pausa ou estende a pausa para o toque. Devolvido por padrão. Não há suporte para parâmetros de consulta. Essa propriedade é somente leitura. |
| featureUpdatesPauseStartDate | Data | A data de início da pausa das Atualizações de Recursos. Esse valor é o momento em que o administrador pausa ou estende a pausa para o toque. 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 Recursos para os quais uma reversão é válida com um intervalo válido de 2 a 60 dias. Devolvido por padrão. Não há suporte para parâmetros de consulta. |
| qualityUpdatesWillBeRolledBack | Booliano | Quando for TRUE, reverter as Atualizações de Qualidade no próximo dispositivo a marcar entrar. Quando for FALSE, não reverta as Atualizações de Qualidade no próximo dispositivo a marcar. Devolvido por padrão. Não há suporte para parâmetros de consulta. |
| featureUpdatesWillBeRolledBack | Booliano | Quando for TRUE, reverter as Atualizações de Recursos no próximo dispositivo a marcar. Quando for FALSE, não reverta as Atualizações de Recursos no próximo dispositivo a 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 e a hora. 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 | A data de início da Reversão de Atualizações de Recursos é a hora de início. Esse valor é a hora em que o administrador reverteu a atualização de recursos para o anel. Retornado por padrão. Não há suporte para parâmetros de consulta. |
| engagedRestartDeadlineInDays | Int32 | Prazo em dias antes de agendar automaticamente e executar 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 que um usuário pode adiar Notificações de lembrete de reinício engajadas 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 de Reinícios Automáticos agendados fora do horário ativo para o Reinício Estabelecido, 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 que as atualizações de recursos sejam 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 que as atualizações de qualidade sejam 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 | Número de dias após o prazo até que as reinicializações ocorram automaticamente com um 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 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 de reinicialização automática necessária é ignorada. Os valores possíveis são: NotConfigured, Automatic, User. 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 aviso 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 notificações de aviso iminentes de reinício automático. Valores suportados: 15, 30 ou 60 (minutos). Devolvido por padrão. Não há suporte para parâmetros de consulta. |
| userPauseAccess | habilitação | Especifica se o acesso do usuário final deve ser habilitado para pausar atualizações de software. Os valores possíveis são: NotConfigured, Enabled, Disabled. Devolvido por padrão. Não há suporte para parâmetros de consulta. Os valores possíveis são: notConfigured, enabled, disabled. |
| userWindowsUpdateScanAccess | habilitação | Especifica se o acesso do usuário deve ser desabilitado para verificar o Windows Update. Os valores possíveis são: NotConfigured, Enabled, Disabled. 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 do 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 o 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 | Configuração do dispositivo, status de instalação por 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
}