Créer deviceManagementScriptCreate deviceManagementScript

  • 2 minutes de lecture

Espace de noms: microsoft.graphNamespace: microsoft.graph

Important : Les API Microsoft Graph sous la version/beta peuvent faire l’objet de modifications ; l’utilisation de la production n’est pas prise en charge.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

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.

Crée un objet deviceManagementScript .Create a new deviceManagementScript 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)
    Gestion des périphériques    Device management DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All
   Jeu de stratégie    Policy Set DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication
    Gestion des périphériques    Device management DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All
   Jeu de stratégie    Policy Set DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All

Requête HTTPHTTP Request

POST /deviceManagement/deviceManagementScripts

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 deviceManagementScript.In the request body, supply a JSON representation for the deviceManagementScript object.

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

PropriétéProperty TypeType DescriptionDescription
idid StringString Identificateur unique pour le script de gestion des périphériques.Unique Identifier for the device management script.
displayNamedisplayName StringString Nom du script de gestion des périphériques.Name of the device management script.
descriptiondescription StringString Description facultative du script de gestion des périphériques.Optional description for the device management script.
runSchedulerunSchedule runSchedulerunSchedule Intervalle de script à exécuter.The interval for script to run. Si ce n’est pas le cas, le script s’exécute une seule fois.If not defined the script will run once
scriptContentscriptContent BinaireBinary Contenu du script.The script content.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Date et heure de création du script de gestion des appareils.The date and time the device management script was created. Cette propriété est en lecture seule.This property is read-only.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Date et heure de la dernière modification du script de gestion des appareils.The date and time the device management script was last modified. Cette propriété est en lecture seule.This property is read-only.
runAsAccountrunAsAccount runAsAccountTyperunAsAccountType Indique le type de contexte d’exécution.Indicates the type of execution context. Les valeurs possibles sont les suivantes : system, user.Possible values are: system, user.
enforceSignatureCheckenforceSignatureCheck BooléenBoolean Indiquez si la signature de script doit être vérifiée.Indicate whether the script signature needs be checked.
fileNamefileName StringString Nom du fichier de script.Script file name.
roleScopeTagIdsroleScopeTagIds String collectionString collection Liste des ID de balise d’étendue pour cette instance PowerShellScript.List of Scope Tag IDs for this PowerShellScript instance.
runAs32BitrunAs32Bit BooléenBoolean Une valeur indiquant si le script PowerShell doit s’exécuter en tant que 32 bitsA value indicating whether the PowerShell script should run as 32-bit

RéponseResponse

Si elle réussit, cette méthode renvoie un 201 Created Code de réponse et un objet deviceManagementScript dans le corps de la réponse.If successful, this method returns a 201 Created response code and a deviceManagementScript object in the response body.

ExempleExample

DemandeRequest

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

POST https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts
Content-type: application/json
Content-length: 443

{
  "@odata.type": "#microsoft.graph.deviceManagementScript",
  "displayName": "Display Name value",
  "description": "Description value",
  "runSchedule": {
    "@odata.type": "microsoft.graph.runSchedule"
  },
  "scriptContent": "c2NyaXB0Q29udGVudA==",
  "runAsAccount": "user",
  "enforceSignatureCheck": true,
  "fileName": "File Name value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "runAs32Bit": 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 201 Created
Content-Type: application/json
Content-Length: 615

{
  "@odata.type": "#microsoft.graph.deviceManagementScript",
  "id": "59ea4525-4525-59ea-2545-ea592545ea59",
  "displayName": "Display Name value",
  "description": "Description value",
  "runSchedule": {
    "@odata.type": "microsoft.graph.runSchedule"
  },
  "scriptContent": "c2NyaXB0Q29udGVudA==",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "runAsAccount": "user",
  "enforceSignatureCheck": true,
  "fileName": "File Name value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "runAs32Bit": true
}