Tipo de recurso windowsUpdateForBusinessConfiguration
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-lhe especificar como e quando o Windows as a Service atualiza os seus dispositivos Windows 10/11 com atualizações de funcionalidades e qualidade. Suporta cláusulas ODATA suportadas pela entidade DeviceConfiguration: $filter por tipos de DeviceConfiguration, $top, $select apenas propriedades de base DeviceConfiguration, $orderby apenas propriedades de base DeviceConfiguration e $skip. O parâmetro de consulta "$search" não é suportado.
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 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 Atualizações de Qualidade 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 Atualizações de Funcionalidades 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 atualizações de qualidade em pausa. 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 atualizações de funcionalidades em pausa. Devolvido por padrão. Os parâmetros de consulta não são suportados.s |
| qualityUpdatesPauseExpiryDateTime | DateTimeOffset | As Atualizações de Qualidade interrompem 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. |
| featureUpdatesPauseExpiryDateTime | DateTimeOffset | As Atualizações de Funcionalidades interrompem 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 da Pausa das Atualizações de 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 data de início da Pausa das Atualizações de Funcionalidades. 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 verificação de Atualizações de Qualidade no próximo dispositivo. Quando for FALSO, não reverta a verificação de Atualizações de Qualidade no próximo dispositivo. Devolvido por padrão. Os parâmetros de consulta não são suportados. |
| featureUpdatesWillBeRolledBack | Booliano | Quando VERDADEIRO, reverta as Atualizações de Funcionalidades no próximo dispositivo. Quando for FALSO, não reverta as Atualizações de Funcionalidades no próximo dispositivo. Devolvido por predefinição. Os parâmetros de consulta não são suportados. |
| qualityUpdatesRollbackStartDateTime | DateTimeOffset | Data/hora de Início da Reversão de 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 datetime de Início da Reversão de Atualizações de Funcionalidades. 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 o 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 veem com notificações do Windows Update. 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 o 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. |
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 | Estado de instalação da configuração do dispositivo por utilizador. 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
}