Mettre à jour macOSEndpointProtectionConfiguration

Espace de noms: microsoft.graph

Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.

Mettez à jour les propriétés d’un objet macOSEndpointProtectionConfiguration .

Cette API est disponible dans les déploiements de cloud national suivants.

Service global	Gouvernement des États-Unis L4	Us Government L5 (DOD)	Chine gérée par 21Vianet
✅	✅	✅	✅

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	DeviceManagementConfiguration.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	DeviceManagementConfiguration.ReadWrite.All

Requête HTTP

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

En-têtes de demande

En-tête	Valeur
Autorisation	Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Accepter	application/json

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON pour l’objet macOSEndpointProtectionConfiguration .

Le tableau suivant présente les propriétés requises lorsque vous créez macOSEndpointProtectionConfiguration.

Propriété	Type	Description
id	String	Clé de l’entité. Hérité de deviceConfiguration.
lastModifiedDateTime	DateTimeOffset	Date et heure de dernière modification de l’objet. Hérité de deviceConfiguration.
roleScopeTagIds	String collection	Liste des balises d’étendue pour cette instance d’entité. Hérité de deviceConfiguration.
supportsScopeTags	Valeur booléenne	Indique si la configuration d’appareil sous-jacente prend en charge l’attribution des balises d’étendue. L’attribution à la propriété ScopeTags n’est pas autorisée lorsque cette valeur est false et que les entités ne sont pas visibles par les utilisateurs délimités. Cela se produit pour les stratégies héritées créées dans Silverlight et peut être résolu en supprimant et en recréant la stratégie dans le portail Azure. Cette propriété est en lecture seule. Hérité de deviceConfiguration.
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	Applicabilité de l’édition du système d’exploitation pour cette stratégie. Hérité de deviceConfiguration.
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	Règle d’applicabilité de la version du système d’exploitation pour cette stratégie. Hérité de deviceConfiguration.
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	Règle d’applicabilité du mode appareil pour cette stratégie. Hérité de deviceConfiguration.
createdDateTime	DateTimeOffset	Date et heure de création de l’objet. Hérité de deviceConfiguration.
description	String	Description de la configuration de l’appareil fournie par l’administrateur. Hérité de deviceConfiguration.
displayName	String	Nom de la configuration de l’appareil fourni par l’administrateur. Hérité de deviceConfiguration.
version	Int32	Version de la configuration de l’appareil. Hérité de deviceConfiguration.
gatekeeperAllowedAppSource	macOSGatekeeperAppSources	Paramètre système et confidentialité qui détermine les emplacements de téléchargement à partir desquels les applications peuvent être exécutées sur un appareil macOS. Les valeurs possibles sont les suivantes : notConfigured, macAppStore, macAppStoreAndIdentifiedDevelopers, anywhere.
gatekeeperBlockOverride	Valeur booléenne	Si la valeur est true, le remplacement de l’utilisateur pour Gatekeeper est désactivé.
firewallEnabled	Valeur booléenne	Indique si le pare-feu doit être activé ou non.
firewallBlockAllIncoming	Valeur booléenne	Correspond à l’option « Bloquer toutes les connexions entrantes ».
firewallEnableStealthMode	Valeur booléenne	Correspond à « Activer le mode furtif ».
firewallApplications	Collection macOSFirewallApplication	Liste des applications avec des paramètres de pare-feu. Les paramètres de pare-feu pour les applications qui ne figurent pas dans cette liste sont déterminés par l’utilisateur. Cette collection peut contenir 500 éléments au maximum.
fileVaultEnabled	Valeur booléenne	Indique si FileVault doit être activé ou non.
fileVaultSelectedRecoveryKeyTypes	macOSFileVaultRecoveryKeyTypes	Obligatoire si FileVault est activé, détermine le ou les types de clé de récupération à utiliser. . Les valeurs possibles sont notConfigured, institutionalRecoveryKey et personalRecoveryKey.
fileVaultAuthorizedRecoveryKeyCertificate	Binaire	Obligatoire si le ou les types de clés de récupération sélectionnés incluent InstitutionalRecoveryKey. Fichier de certificat encodé DER utilisé pour définir une clé de récupération institutionnelle.
fileVaultAuthorizedRecoveryKeyCertificateFileName	Chaîne	Nom de fichier du certificat de clé de récupération institutionnelle à afficher dans l’interface utilisateur. (*.der).
fileVaultPersonalRecoveryKeyHelpMessage	Chaîne	Obligatoire si le ou les types de clés de récupération sélectionnés incluent PersonalRecoveryKey. Un court message s’affiche à l’utilisateur qui explique comment récupérer sa clé de récupération personnelle.
fileVaultAllowDeferralUntilSignOut	Boolean	Facultatif. Si la valeur est true, l’utilisateur peut différer l’activation de FileVault jusqu’à ce qu’il se déconnecte.
fileVaultNumberOfTimesUserCanIgnore	Int32	Optional. Lorsque vous utilisez l’option Différer, il s’agit du nombre maximal de fois que l’utilisateur peut ignorer les invites pour activer FileVault avant que FileVault ne soit requis pour que l’utilisateur se connecte. S’il est défini sur -1, il est toujours invité à activer FileVault jusqu’à ce que FileVault soit activé, mais il permet à l’utilisateur de contourner l’activation de FileVault. La définition de cette valeur sur 0 désactive la fonctionnalité.
fileVaultDisablePromptAtSignOut	Boolean	Facultatif. Lorsque vous utilisez l’option Différer, si la valeur est true, l’utilisateur n’est pas invité à activer FileVault lors de la déconnexion.
fileVaultPersonalRecoveryKeyRotationInMonths	Int32	Optional. Si le ou les types de clés de récupération sélectionnés incluent PersonalRecoveryKey, la fréquence de rotation de cette clé, en mois.
fileVaultHidePersonalRecoveryKey	Boolean	Facultatif. Une clé de récupération personnelle masquée n’apparaît pas sur l’écran de l’utilisateur pendant le chiffrement FileVault, ce qui réduit le risque qu’elle se retrouve entre de mauvaises mains.
advancedThreatProtectionRealTime	Enablement	Détermine s’il faut activer ou non la protection en temps réel pour Microsoft Defender Advanced Threat Protection sur macOS. Les valeurs possibles sont notConfigured, enabled et disabled.
advancedThreatProtectionCloudDelivered	Enablement	Détermine s’il faut activer ou non la protection fournie par le cloud pour Microsoft Defender Advanced Threat Protection sur macOS. Les valeurs possibles sont notConfigured, enabled et disabled.
advancedThreatProtectionAutomaticSampleSubmission	Enablement	Détermine s’il faut activer ou non l’envoi automatique d’exemples de fichiers pour Microsoft Defender Advanced Threat Protection sur macOS. Les valeurs possibles sont notConfigured, enabled et disabled.
advancedThreatProtectionDiagnosticDataCollection	Enablement	Détermine s’il faut activer ou non la collecte des données de diagnostic et d’utilisation pour Microsoft Defender Advanced Threat Protection sur macOS. Les valeurs possibles sont notConfigured, enabled et disabled.
advancedThreatProtectionExcludedFolders	String collection	Liste des chemins d’accès aux dossiers à exclure de l’analyse antivirus pour Microsoft Defender Advanced Threat Protection sur macOS.
advancedThreatProtectionExcludedFiles	String collection	Liste des chemins d’accès aux fichiers à exclure de l’analyse antivirus pour Microsoft Defender Advanced Threat Protection sur macOS.
advancedThreatProtectionExcludedExtensions	String collection	Liste des extensions de fichier à exclure de l’analyse antivirus pour Microsoft Defender Advanced Threat Protection sur macOS.
advancedThreatProtectionExcludedProcesses	Collection de chaînes	Liste des noms de processus à exclure de l’analyse antivirus pour Microsoft Defender Advanced Threat Protection sur macOS.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet macOSEndpointProtectionConfiguration mis à jour dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

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

{
  "@odata.type": "#microsoft.graph.macOSEndpointProtectionConfiguration",
  "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,
  "gatekeeperAllowedAppSource": "macAppStore",
  "gatekeeperBlockOverride": true,
  "firewallEnabled": true,
  "firewallBlockAllIncoming": true,
  "firewallEnableStealthMode": true,
  "firewallApplications": [
    {
      "@odata.type": "microsoft.graph.macOSFirewallApplication",
      "bundleId": "Bundle Id value",
      "allowsIncomingConnections": true
    }
  ],
  "fileVaultEnabled": true,
  "fileVaultSelectedRecoveryKeyTypes": "institutionalRecoveryKey",
  "fileVaultInstitutionalRecoveryKeyCertificate": "ZmlsZVZhdWx0SW5zdGl0dXRpb25hbFJlY292ZXJ5S2V5Q2VydGlmaWNhdGU=",
  "fileVaultInstitutionalRecoveryKeyCertificateFileName": "File Vault Institutional Recovery Key Certificate File Name value",
  "fileVaultPersonalRecoveryKeyHelpMessage": "File Vault Personal Recovery Key Help Message value",
  "fileVaultAllowDeferralUntilSignOut": true,
  "fileVaultNumberOfTimesUserCanIgnore": 3,
  "fileVaultDisablePromptAtSignOut": true,
  "fileVaultPersonalRecoveryKeyRotationInMonths": 12,
  "fileVaultHidePersonalRecoveryKey": true,
  "advancedThreatProtectionRealTime": "enabled",
  "advancedThreatProtectionCloudDelivered": "enabled",
  "advancedThreatProtectionAutomaticSampleSubmission": "enabled",
  "advancedThreatProtectionDiagnosticDataCollection": "enabled",
  "advancedThreatProtectionExcludedFolders": [
    "Advanced Threat Protection Excluded Folders value"
  ],
  "advancedThreatProtectionExcludedFiles": [
    "Advanced Threat Protection Excluded Files value"
  ],
  "advancedThreatProtectionExcludedExtensions": [
    "Advanced Threat Protection Excluded Extensions value"
  ],
  "advancedThreatProtectionExcludedProcesses": [
    "Advanced Threat Protection Excluded Processes value"
  ]
}

Réponse

Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2958

{
  "@odata.type": "#microsoft.graph.macOSEndpointProtectionConfiguration",
  "id": "7bf7f3ca-f3ca-7bf7-caf3-f77bcaf3f77b",
  "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,
  "gatekeeperAllowedAppSource": "macAppStore",
  "gatekeeperBlockOverride": true,
  "firewallEnabled": true,
  "firewallBlockAllIncoming": true,
  "firewallEnableStealthMode": true,
  "firewallApplications": [
    {
      "@odata.type": "microsoft.graph.macOSFirewallApplication",
      "bundleId": "Bundle Id value",
      "allowsIncomingConnections": true
    }
  ],
  "fileVaultEnabled": true,
  "fileVaultSelectedRecoveryKeyTypes": "institutionalRecoveryKey",
  "fileVaultInstitutionalRecoveryKeyCertificate": "ZmlsZVZhdWx0SW5zdGl0dXRpb25hbFJlY292ZXJ5S2V5Q2VydGlmaWNhdGU=",
  "fileVaultInstitutionalRecoveryKeyCertificateFileName": "File Vault Institutional Recovery Key Certificate File Name value",
  "fileVaultPersonalRecoveryKeyHelpMessage": "File Vault Personal Recovery Key Help Message value",
  "fileVaultAllowDeferralUntilSignOut": true,
  "fileVaultNumberOfTimesUserCanIgnore": 3,
  "fileVaultDisablePromptAtSignOut": true,
  "fileVaultPersonalRecoveryKeyRotationInMonths": 12,
  "fileVaultHidePersonalRecoveryKey": true,
  "advancedThreatProtectionRealTime": "enabled",
  "advancedThreatProtectionCloudDelivered": "enabled",
  "advancedThreatProtectionAutomaticSampleSubmission": "enabled",
  "advancedThreatProtectionDiagnosticDataCollection": "enabled",
  "advancedThreatProtectionExcludedFolders": [
    "Advanced Threat Protection Excluded Folders value"
  ],
  "advancedThreatProtectionExcludedFiles": [
    "Advanced Threat Protection Excluded Files value"
  ],
  "advancedThreatProtectionExcludedExtensions": [
    "Advanced Threat Protection Excluded Extensions value"
  ],
  "advancedThreatProtectionExcludedProcesses": [
    "Advanced Threat Protection Excluded Processes value"
  ]
}