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.
Atualizar as propriedades de um objeto windows81GeneralConfiguration.
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
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/"
}