Share via


Atualizar windows81GeneralConfiguration

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 windows81GeneralConfiguration.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA 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 windows81GeneralConfiguration.

A tabela a seguir mostra as propriedades que são necessárias ao criar windows81GeneralConfiguration.

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
accountsBlockAddingNonMicrosoftAccountEmail Boolean Indica se o usuário será impedido ou não de adicionar ao dispositivo contas de email não associadas a uma conta da Microsoft.
applyOnlyToWindows81 Boolean Valor que indica se esta política se aplica somente ao Windows 8.1. Essa propriedade é somente leitura.
browserBlockAutofill Boolean Indica se o preenchimento automático deve ou não ser bloqueado.
browserBlockAutomaticDetectionOfIntranetSites Boolean Indica se a detecção automática de sites da Intranet deve ou não ser bloqueada.
browserBlockEnterpriseModeAccess Boolean Indica se o acesso ao modo Empresarial deve ou não ser bloqueado.
browserBlockJavaScript Boolean Indica se o usuário será ou não impedido de usar JavaScript.
browserBlockPlugins Boolean Indica se os plug-ins devem ou não ser bloqueados.
browserBlockPopups Boolean Indica se janelas pop-ups devem ou não ser bloqueadas.
browserBlockSendingDoNotTrackHeader Boolean Indica se o usuário será ou não impedido de enviar o cabeçalho Do Not Track.
browserBlockSingleWordEntryOnIntranetSites Boolean Indica se a entrada de palavra única em sites da Intranet deve ou não ser bloqueada.
browserRequireSmartScreen Boolean Indica se o usuário deverá ou não usar o Filtro SmartScreen.
browserEnterpriseModeSiteListLocation String O local da lista de sites do modo Empresarial. Pode ser um arquivo local, rede local ou local http.
browserInternetSecurityLevel internetSiteSecurityLevel O nível de segurança da Internet. Os valores possíveis são: userDefined, medium, mediumHigh, high.
browserIntranetSecurityLevel siteSecurityLevel O nível de segurança da Intranet. Os valores possíveis são: userDefined, low, mediumLow, medium, mediumHigh, high.
browserLoggingReportLocation String O local do relatório de registro em log.
browserRequireHighSecurityForRestrictedSites Boolean Indica se a alta segurança para sites restritos deve ou não ser exigida.
browserRequireFirewall Boolean Indica se um firewall deve ou não ser exigido.
browserRequireFraudWarning Boolean Indica se um aviso de fraude deve ou não ser exigido.
browserTrustedSitesSecurityLevel siteSecurityLevel O nível de segurança de sites confiáveis. Os valores possíveis são: userDefined, low, mediumLow, medium, mediumHigh, high.
cellularBlockDataRoaming Boolean Indica se o roaming de dados deve ou não ser bloqueado.
diagnosticsBlockDataSubmission Boolean Indica se o envio de dados de diagnóstico deve ou não ser bloqueado.
passwordBlockPicturePasswordAndPin Boolean Indica se o usuário será ou não impedido de usar senha com imagens ou pin.
passwordExpirationDays Int32 Expiração da senha em dias.
passwordMinimumLength Int32 O comprimento mínimo da senha.
passwordMinutesOfInactivityBeforeScreenTimeout Int32 Os minutos de inatividade antes que a tela atinja o tempo limite.
passwordMinimumCharacterSetCount Int32 O número de conjuntos de caracteres necessários na senha.
passwordPreviousPasswordBlockCount Int32 O número de senhas anteriores cujo uso deve ser evitado. Valores válidos de 0 a 24
passwordRequiredType requiredPasswordType O tipo de senha necessária. Os valores possíveis são: deviceDefault, alphanumeric, numeric.
passwordSignInFailureCountBeforeFactoryReset Int32 O número de falhas de entrada antes da redefinição de fábrica.
storageRequireDeviceEncryption Boolean Indica se a criptografia é ou não necessária em um dispositivo móvel.
updatesRequireAutomaticUpdates Boolean Indica se as atualizações automáticas devem ou não ser exigidas.
userAccountControlSettings windowsUserAccountControlSettings As configurações de controle da conta do usuário. Os valores possíveis são: userDefined, alwaysNotify, notifyOnAppChanges, notifyOnAppChangesWithoutDimming, neverNotify.
workFoldersUrl String A URL das pastas de trabalho

Resposta

Se bem-sucedido, este método retornará um código de resposta 200 OK e um objeto windows81GeneralConfiguration 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: 1693

{
  "@odata.type": "#microsoft.graph.windows81GeneralConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "accountsBlockAddingNonMicrosoftAccountEmail": true,
  "applyOnlyToWindows81": true,
  "browserBlockAutofill": true,
  "browserBlockAutomaticDetectionOfIntranetSites": true,
  "browserBlockEnterpriseModeAccess": true,
  "browserBlockJavaScript": true,
  "browserBlockPlugins": true,
  "browserBlockPopups": true,
  "browserBlockSendingDoNotTrackHeader": true,
  "browserBlockSingleWordEntryOnIntranetSites": true,
  "browserRequireSmartScreen": true,
  "browserEnterpriseModeSiteListLocation": "Browser Enterprise Mode Site List Location value",
  "browserInternetSecurityLevel": "medium",
  "browserIntranetSecurityLevel": "low",
  "browserLoggingReportLocation": "Browser Logging Report Location value",
  "browserRequireHighSecurityForRestrictedSites": true,
  "browserRequireFirewall": true,
  "browserRequireFraudWarning": true,
  "browserTrustedSitesSecurityLevel": "low",
  "cellularBlockDataRoaming": true,
  "diagnosticsBlockDataSubmission": true,
  "passwordBlockPicturePasswordAndPin": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordMinimumCharacterSetCount": 0,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordRequiredType": "alphanumeric",
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "storageRequireDeviceEncryption": true,
  "updatesRequireAutomaticUpdates": true,
  "userAccountControlSettings": "alwaysNotify",
  "workFoldersUrl": "https://example.com/workFoldersUrl/"
}

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: 1865

{
  "@odata.type": "#microsoft.graph.windows81GeneralConfiguration",
  "id": "0e9285b5-85b5-0e92-b585-920eb585920e",
  "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,
  "accountsBlockAddingNonMicrosoftAccountEmail": true,
  "applyOnlyToWindows81": true,
  "browserBlockAutofill": true,
  "browserBlockAutomaticDetectionOfIntranetSites": true,
  "browserBlockEnterpriseModeAccess": true,
  "browserBlockJavaScript": true,
  "browserBlockPlugins": true,
  "browserBlockPopups": true,
  "browserBlockSendingDoNotTrackHeader": true,
  "browserBlockSingleWordEntryOnIntranetSites": true,
  "browserRequireSmartScreen": true,
  "browserEnterpriseModeSiteListLocation": "Browser Enterprise Mode Site List Location value",
  "browserInternetSecurityLevel": "medium",
  "browserIntranetSecurityLevel": "low",
  "browserLoggingReportLocation": "Browser Logging Report Location value",
  "browserRequireHighSecurityForRestrictedSites": true,
  "browserRequireFirewall": true,
  "browserRequireFraudWarning": true,
  "browserTrustedSitesSecurityLevel": "low",
  "cellularBlockDataRoaming": true,
  "diagnosticsBlockDataSubmission": true,
  "passwordBlockPicturePasswordAndPin": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordMinimumCharacterSetCount": 0,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordRequiredType": "alphanumeric",
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "storageRequireDeviceEncryption": true,
  "updatesRequireAutomaticUpdates": true,
  "userAccountControlSettings": "alwaysNotify",
  "workFoldersUrl": "https://example.com/workFoldersUrl/"
}