Update macOSCompliancePolicyUpdate macOSCompliancePolicy

Espace de noms : microsoft.graphNamespace: microsoft.graph

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Met à jour les propriétés d’un objet macOSCompliancePolicy.Update the properties of a macOSCompliancePolicy object.

Conditions préalablesPrerequisites

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (par ordre décroissant du niveau de privilège)Permissions (from most to least privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication Non prise en charge.Not supported.

Requête HTTPHTTP Request

PATCH /deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}

En-têtes de demandeRequest headers

En-têteHeader ValeurValue
AutorisationAuthorization Porteur <token> obligatoire.Bearer <token> Required.
AccepterAccept application/jsonapplication/json

Corps de la demandeRequest body

Dans le corps de la demande, fournissez une représentation JSON de l’objet macOSCompliancePolicy.In the request body, supply a JSON representation for the macOSCompliancePolicy object.

Le tableau suivant indique les propriétés qui sont requises lorsque vous créez l’objet macOSCompliancePolicy.The following table shows the properties that are required when you create the macOSCompliancePolicy.

PropriétéProperty TypeType DescriptionDescription
idid StringString Clé de l’entité.Key of the entity. Hérité de deviceCompliancePolicy.Inherited from deviceCompliancePolicy
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Date et heure de création de l’objet.DateTime the object was created. Hérité de deviceCompliancePolicy.Inherited from deviceCompliancePolicy
descriptiondescription StringString Description de la configuration de l’appareil fournie par l’administrateur.Admin provided description of the Device Configuration. Hérité de deviceCompliancePolicy.Inherited from deviceCompliancePolicy
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Date et heure de dernière modification de l’objet.DateTime the object was last modified. Hérité de deviceCompliancePolicy.Inherited from deviceCompliancePolicy
displayNamedisplayName StringString Nom de la configuration de l’appareil fourni par l’administrateur.Admin provided name of the device configuration. Hérité de deviceCompliancePolicy.Inherited from deviceCompliancePolicy
versionversion Int32Int32 Version de la configuration de l’appareil.Version of the device configuration. Hérité de deviceCompliancePolicy.Inherited from deviceCompliancePolicy
passwordRequiredpasswordRequired BooléenBoolean Indique si un mot de passe est exigé ou non.Whether or not to require a password.
passwordBlockSimplepasswordBlockSimple BooléenBoolean Indique si les mots de passe simples sont bloqués ou non.Indicates whether or not to block simple passwords.
passwordExpirationDayspasswordExpirationDays Int32Int32 Nombre de jours avant l’expiration du mot de passe.Number of days before the password expires. Valeurs valides comprises entre 1 et 65 535Valid values 1 to 65535
passwordMinimumLengthpasswordMinimumLength Int32Int32 Longueur minimale de mot de passe.Minimum length of password. Valeurs valides comprises entre 4 et 14Valid values 4 to 14
passwordMinutesOfInactivityBeforeLockpasswordMinutesOfInactivityBeforeLock Int32Int32 Minutes d’inactivité avant qu’un mot de passe soit nécessaire.Minutes of inactivity before a password is required.
passwordPreviousPasswordBlockCountpasswordPreviousPasswordBlockCount Int32Int32 Nombre de mots de passe précédents à bloquer.Number of previous passwords to block. Valeurs valides comprises entre 1 et 24Valid values 1 to 24
passwordMinimumCharacterSetCountpasswordMinimumCharacterSetCount Int32Int32 Nombre de jeux de caractères requis dans le mot de passe.The number of character sets required in the password.
passwordRequiredTypepasswordRequiredType requiredPasswordTyperequiredPasswordType Type de mot de passe requis.The required password type. Les valeurs possibles sont les suivantes : deviceDefault, alphanumeric et numeric.Possible values are: deviceDefault, alphanumeric, numeric.
osMinimumVersionosMinimumVersion StringString Version Mac minimale.Minimum MacOS version.
osMaximumVersionosMaximumVersion StringString Version maximale d’MacOS.Maximum MacOS version.
systemIntegrityProtectionEnabledsystemIntegrityProtectionEnabled BooléenBoolean Exige que la protection d’intégrité de système soit activée pour les appareils.Require that devices have enabled system integrity protection.
deviceThreatProtectionEnableddeviceThreatProtectionEnabled BooléenBoolean Exige que la protection contre les menaces sur les appareils soit activée pour les appareils.Require that devices have enabled device threat protection.
deviceThreatProtectionRequiredSecurityLeveldeviceThreatProtectionRequiredSecurityLevel deviceThreatProtectionLeveldeviceThreatProtectionLevel Requiert le niveau de risque minimal pour la protection contre les menaces sur appareil mobile pour signaler toute non-conformité.Require Mobile Threat Protection minimum risk level to report noncompliance. Les valeurs possibles sont les suivantes : unavailable, secured, low, medium, high et notSet.Possible values are: unavailable, secured, low, medium, high, notSet.
storageRequireEncryptionstorageRequireEncryption BooléenBoolean Exige le chiffrement sur les appareils Mac OS.Require encryption on Mac OS devices.
firewallEnabledfirewallEnabled BooleanBoolean Indique si le pare-feu doit être activé ou non.Whether the firewall should be enabled or not.
firewallBlockAllIncomingfirewallBlockAllIncoming BooleanBoolean Correspond à l’option « bloquer toutes les connexions entrantes ».Corresponds to the “Block all incoming connections” option.
firewallEnableStealthModefirewallEnableStealthMode BooleanBoolean Correspond à « activer le mode furtif ».Corresponds to “Enable stealth mode.”

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et un objet macOSCompliancePolicy mis à jour dans le corps de la réponse.If successful, this method returns a 200 OK response code and an updated macOSCompliancePolicy object in the response body.

ExempleExample

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}
Content-type: application/json
Content-length: 849

{
  "@odata.type": "#microsoft.graph.macOSCompliancePolicy",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordRequired": true,
  "passwordBlockSimple": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeLock": 5,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordMinimumCharacterSetCount": 0,
  "passwordRequiredType": "alphanumeric",
  "osMinimumVersion": "Os Minimum Version value",
  "osMaximumVersion": "Os Maximum Version value",
  "systemIntegrityProtectionEnabled": true,
  "deviceThreatProtectionEnabled": true,
  "deviceThreatProtectionRequiredSecurityLevel": "secured",
  "storageRequireEncryption": true,
  "firewallEnabled": true,
  "firewallBlockAllIncoming": true,
  "firewallEnableStealthMode": true
}

RéponseResponse

Voici un exemple de la 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.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

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

{
  "@odata.type": "#microsoft.graph.macOSCompliancePolicy",
  "id": "ddbadff3-dff3-ddba-f3df-baddf3dfbadd",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "displayName": "Display Name value",
  "version": 7,
  "passwordRequired": true,
  "passwordBlockSimple": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeLock": 5,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordMinimumCharacterSetCount": 0,
  "passwordRequiredType": "alphanumeric",
  "osMinimumVersion": "Os Minimum Version value",
  "osMaximumVersion": "Os Maximum Version value",
  "systemIntegrityProtectionEnabled": true,
  "deviceThreatProtectionEnabled": true,
  "deviceThreatProtectionRequiredSecurityLevel": "secured",
  "storageRequireEncryption": true,
  "firewallEnabled": true,
  "firewallBlockAllIncoming": true,
  "firewallEnableStealthMode": true
}