Atualizar windowsWifiEnterpriseEAPConfiguration

Namespace: microsoft.graph

Importante: As GRAPH da Microsoft na versão /beta estão sujeitas a alterações; o uso de produção não é suportado.

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

Atualize as propriedades de um objeto windowsWifiEnterpriseEAPConfiguration .

Pré-requisitos

Uma das seguintes permissões é obrigató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.
Aplicativo	DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	<Token> de portador obrigatório.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, fornece uma representação JSON para o objeto windowsWifiEnterpriseEAPConfiguration .

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

Propriedade	Tipo	Descrição
id	Cadeia de caracteres	Chave da entidade. Herdada de deviceConfiguration
lastModifiedDateTime	DateTimeOffset	DateTime da última modificação do objeto. Herdada de deviceConfiguration
roleScopeTagIds	String collection	Lista de marcas de escopo para esta instância entity. Herdada de deviceConfiguration
supportsScopeTags	Boolean	Indica se a Configuração de Dispositivo subjacente dá suporte ou não à atribuição de marcas de escopo. A atribuição à propriedade ScopeTags não é permitida quando esse valor é falso e as entidades não estarão visíveis para usuários com escopo. Isso ocorre para políticas herdadas criadas no Silverlight e podem ser resolvidas excluindo e recriando a política no Portal do Azure. Essa propriedade é somente leitura. Herdada de deviceConfiguration
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	A aplicabilidade da edição do sistema operacional para esta Política. Herdada de deviceConfiguration
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	A regra de aplicabilidade da versão do sistema operacional para esta Política. Herdada de deviceConfiguration
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	A regra de aplicabilidade do modo de dispositivo para esta Política. Herdada de deviceConfiguration
createdDateTime	DateTimeOffset	DateTime em que o objeto foi criado. Herdada de deviceConfiguration
description	Cadeia de caracteres	O administrador forneceu a descrição da Configuração do dispositivo. Herdada de deviceConfiguration
displayName	Cadeia de caracteres	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
preSharedKey	Cadeia de caracteres	Esta é a chave pré-compartilhada para a rede WPA Personal Wi-Fi. Herdado do windowsWifiConfiguration
wifiSecurityType	wiFiSecurityType	Especifique o Tipo de Segurança Wifi. Herdado do windowsWifiConfiguration. Os possíveis valores são: open, wpaPersonal, wpaEnterprise, wep, wpa2Personal, wpa2Enterprise.
meteredConnectionLimit	meteredConnectionLimitType	Especifique o tipo de limite de conexão limitado para a conexão wifi. Herdado do windowsWifiConfiguration. Os valores possíveis são: unrestricted, fixed, variable.
ssid	Cadeia de caracteres	Especifique o SSID da conexão wifi. Herdado do windowsWifiConfiguration
networkName	Cadeia de caracteres	Especifique o nome da configuração de rede. Herdado do windowsWifiConfiguration
connectAutomatically	Booliano	Especifique se a conexão wifi deve se conectar automaticamente quando estiver no intervalo. Herdado do windowsWifiConfiguration
connectToPreferredNetwork	Booliano	Especifique se a conexão wifi deve se conectar a redes mais preferenciais quando já estiver conectada a essa. Requer Que ConnectAutomatically seja verdadeiro. Herdado do windowsWifiConfiguration
connectWhenNetworkNameIsHidden	Boolean	Especifique se a conexão wifi deve se conectar automaticamente mesmo quando o SSID não estiver transmitindo. Herdado do windowsWifiConfiguration
proxySetting	wiFiProxySetting	Especifique a configuração de proxy Wi-Fi herdada do windowsWifiConfiguration. Os valores possíveis são: none, manual, automatic.
proxyManualAddress	Cadeia de caracteres	Especifique o endereço IP do servidor proxy. Herdado do windowsWifiConfiguration
proxyManualPort	Int32	Especifique a porta para o servidor proxy. Herdado do windowsWifiConfiguration
proxyAutomaticConfigurationUrl	Cadeia de caracteres	Especifique a URL do script de configuração do servidor proxy. Herdado do windowsWifiConfiguration
forceFIPSCompliance	Boolean	Especifique se deve forçar a conformidade fips. Herdado do windowsWifiConfiguration
networkSingleSignOn	networkSingleSignOnType	Especifique o tipo de sinal único de rede. Os valores possíveis são: disabled, prelogon, postlogon.
maximumAuthenticationTimeoutInSeconds	Int32	Especifique o tempo limite máximo de autenticação (em segundos). Intervalo válido: 1-120
userBasedVirtualLan	Booliano	Especifica se é preciso alterar a LAN virtual usada pelo dispositivo com base nas credenciais do usuário. Não é possível usar quando NetworkSingleSignOnType está definido como Desabilitado.
promptForAdditionalAuthenticationCredentials	Booliano	Especifique se a conexão wifi deve solicitar credenciais de autenticação adicionais.
enablePairwiseMasterKeyCaching	Boolean	Especifique se a conexão wifi deve habilitar o cache de chave mestra par.
maximumPairwiseMasterKeyCacheTimeInMinutes	Int32	Especifique o tempo máximo de cache da chave mestra par (em minutos). Intervalo válido: 5-1440
maximumNumberOfPairwiseMasterKeysInCache	Int32	Especifique o número máximo de chaves mestras de par no cache. Intervalo válido: 1-255
enablePreAuthentication	Booliano	Especifique se a pré-autenticação deve ser habilitada.
maximumPreAuthenticationAttempts	Int32	Especifique as tentativas máximas de pré-autenticação. Intervalo válido: 1-16
eapType	eapType	Protocolo de Autenticação Extensível (EAP). Indica o tipo de conjunto de protocolo EAP no ponto de extremidade Wi-Fi (roteador). Os valores possíveis são: eapTls, leap, eapSim, eapTtls, peap, eapFast, teap.
trustedServerCertificateNames	Conjunto de cadeias de caracteres	Especifique nomes de certificados de servidor confiáveis.
authenticationMethod	wiFiAuthenticationMethod	Especifique o método de autenticação. Os valores possíveis são: certificate, usernameAndPassword, derivedCredential.
innerAuthenticationProtocolForEAPTTLS	nonEapAuthenticationMethodForEapTtlsType	Especifique o protocolo de autenticação interna para TTLS EAP. Os valores possíveis são: unencryptedPassword, challengeHandshakeAuthenticationProtocol, microsoftChap, microsoftChapVersionTwo.
outerIdentityPrivacyTemporaryValue	Cadeia de caracteres	Especifique a cadeia de caracteres para substituir nomes de usuário para privacidade ao usar TTLS EAP ou PEAP.
requireCryptographicBinding	Boolean	Especifique se deve habilitar a associação criptográfica quando o tipo EAP estiver selecionado como PEAP.
performServerValidation	Booliano	Especifique se deve habilitar a verificação da identidade do servidor validando o certificado quando o tipo EAP for selecionado como PEAP.
disableUserPromptForServerValidation	Boolean	Especifique se o usuário deve ser solicitado a autorizar novos servidores para autoridades de certificação confiáveis quando o tipo EAP for selecionado como PEAP.
authenticationPeriodInSeconds	Int32	Especifique o número de segundos para o cliente aguardar após uma tentativa de autenticação antes de falhar. Intervalo válido 1-3600.
authenticationRetryDelayPeriodInSeconds	Int32	Especifique o número de segundos entre uma autenticação com falha e a próxima tentativa de autenticação. Intervalo válido 1-3600.
eapolStartPeriodInSeconds	Int32	Especifique o número de segundos a ser aguardado antes de enviar uma mensagem inicial EAPOL (Extensible Authentication Protocol over LAN). Intervalo válido 1-3600.
maximumEAPOLStartMessages	Int32	Especifica o número máximo de mensagens EAPOL (Extensible Authentication Protocol over LAN) a serem enviadas antes de retornar a falha. Intervalo válido de 1 a 100.
maximumAuthenticationFailures	Int32	Especifique as falhas máximas de autenticação permitidas para um conjunto de credenciais. Intervalo válido de 1 a 100.
cacheCredentials	Booliano	Especifique se deve armazenar em cache as credenciais do usuário no dispositivo para que os usuários não precisem continuar inserindo-as sempre que se conectarem.
authenticationType	wifiAuthenticationType	Especifique se o usuário, o dispositivo ou o dispositivo devem ser autenticados (nenhum). Se você estiver usando autenticação de certificado, certifique-se de que o tipo de certificado corresponde ao tipo de autenticação. Os valores possíveis são: none, user, machine, machineOrUser, guest.

Resposta

Se tiver êxito, este método retornará 200 OK um código de resposta e um objeto windowsWifiEnterpriseEAPConfiguration atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 2695

{
  "@odata.type": "#microsoft.graph.windowsWifiEnterpriseEAPConfiguration",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "preSharedKey": "Pre Shared Key value",
  "wifiSecurityType": "wpaPersonal",
  "meteredConnectionLimit": "fixed",
  "ssid": "Ssid value",
  "networkName": "Network Name value",
  "connectAutomatically": true,
  "connectToPreferredNetwork": true,
  "connectWhenNetworkNameIsHidden": true,
  "proxySetting": "manual",
  "proxyManualAddress": "Proxy Manual Address value",
  "proxyManualPort": 15,
  "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
  "forceFIPSCompliance": true,
  "networkSingleSignOn": "prelogon",
  "maximumAuthenticationTimeoutInSeconds": 5,
  "userBasedVirtualLan": true,
  "promptForAdditionalAuthenticationCredentials": true,
  "enablePairwiseMasterKeyCaching": true,
  "maximumPairwiseMasterKeyCacheTimeInMinutes": 10,
  "maximumNumberOfPairwiseMasterKeysInCache": 8,
  "enablePreAuthentication": true,
  "maximumPreAuthenticationAttempts": 0,
  "eapType": "leap",
  "trustedServerCertificateNames": [
    "Trusted Server Certificate Names value"
  ],
  "authenticationMethod": "usernameAndPassword",
  "innerAuthenticationProtocolForEAPTTLS": "challengeHandshakeAuthenticationProtocol",
  "outerIdentityPrivacyTemporaryValue": "Outer Identity Privacy Temporary Value value",
  "requireCryptographicBinding": true,
  "performServerValidation": true,
  "disableUserPromptForServerValidation": true,
  "authenticationPeriodInSeconds": 13,
  "authenticationRetryDelayPeriodInSeconds": 7,
  "eapolStartPeriodInSeconds": 9,
  "maximumEAPOLStartMessages": 9,
  "maximumAuthenticationFailures": 13,
  "cacheCredentials": true,
  "authenticationType": "user"
}

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

{
  "@odata.type": "#microsoft.graph.windowsWifiEnterpriseEAPConfiguration",
  "id": "7e7183ac-83ac-7e71-ac83-717eac83717e",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "preSharedKey": "Pre Shared Key value",
  "wifiSecurityType": "wpaPersonal",
  "meteredConnectionLimit": "fixed",
  "ssid": "Ssid value",
  "networkName": "Network Name value",
  "connectAutomatically": true,
  "connectToPreferredNetwork": true,
  "connectWhenNetworkNameIsHidden": true,
  "proxySetting": "manual",
  "proxyManualAddress": "Proxy Manual Address value",
  "proxyManualPort": 15,
  "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
  "forceFIPSCompliance": true,
  "networkSingleSignOn": "prelogon",
  "maximumAuthenticationTimeoutInSeconds": 5,
  "userBasedVirtualLan": true,
  "promptForAdditionalAuthenticationCredentials": true,
  "enablePairwiseMasterKeyCaching": true,
  "maximumPairwiseMasterKeyCacheTimeInMinutes": 10,
  "maximumNumberOfPairwiseMasterKeysInCache": 8,
  "enablePreAuthentication": true,
  "maximumPreAuthenticationAttempts": 0,
  "eapType": "leap",
  "trustedServerCertificateNames": [
    "Trusted Server Certificate Names value"
  ],
  "authenticationMethod": "usernameAndPassword",
  "innerAuthenticationProtocolForEAPTTLS": "challengeHandshakeAuthenticationProtocol",
  "outerIdentityPrivacyTemporaryValue": "Outer Identity Privacy Temporary Value value",
  "requireCryptographicBinding": true,
  "performServerValidation": true,
  "disableUserPromptForServerValidation": true,
  "authenticationPeriodInSeconds": 13,
  "authenticationRetryDelayPeriodInSeconds": 7,
  "eapolStartPeriodInSeconds": 9,
  "maximumEAPOLStartMessages": 9,
  "maximumAuthenticationFailures": 13,
  "cacheCredentials": true,
  "authenticationType": "user"
}