Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Important: Microsoft prend en charge les API Intune /beta, mais elles sont sujettes à des modifications plus fréquentes. Microsoft recommande d’utiliser la version v1.0 si possible. Vérifiez la disponibilité d’une API dans la version v1.0 à l’aide du sélecteur de version.
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Mettez à jour les propriétés d’un objet deviceManagementScript .
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 (par ordre décroissant du niveau de privilège) |
|---|---|
| Déléguée (compte professionnel ou scolaire) | |
| Gestion des appareils | DeviceManagementConfiguration.ReadWrite.All |
| Ensemble de stratégies | DeviceManagementConfiguration.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | |
| Gestion des appareils | DeviceManagementConfiguration.ReadWrite.All |
| Ensemble de stratégies | DeviceManagementConfiguration.ReadWrite.All |
Requête HTTP
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}
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 deviceManagementScript .
Le tableau suivant indique les propriétés requises lorsque vous créez deviceManagementScript.
| Propriété | Type | Description |
|---|---|---|
| id | String | Identificateur unique pour le script de gestion des appareils. |
| displayName | String | Nom du script de gestion des appareils. |
| description | String | Description facultative du script de gestion des appareils. |
| scriptContent | Binary | Contenu du script. |
| createdDateTime | DateTimeOffset | Date et heure de création du script de gestion des appareils. Cette propriété est en lecture seule. |
| lastModifiedDateTime | DateTimeOffset | Date et heure de la dernière modification du script de gestion des appareils. Cette propriété est en lecture seule. |
| runAsAccount | exécuter En tant que Type de Compte | Indique le type de contexte d’exécution. Les valeurs possibles sont : system, user. |
| enforceSignatureCheck | Booléen | Indiquez si la signature du script doit être vérifiée. |
| fileName | String | Nom du fichier de script. |
| roleScopeTagIds | String collection | Liste des ID de balise d’étendue pour cette instance PowerShellScript. |
| runAs32Bit | Booléen | Valeur indiquant si le script PowerShell doit s’exécuter en tant que 32 bits |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet deviceManagementScript mis à jour dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}
Content-type: application/json
Content-length: 443
{
"@odata.type": "#microsoft.graph.deviceManagementScript",
"displayName": "Display Name value",
"description": "Description value",
"scriptContent": "c2NyaXB0Q29udGVudA==",
"runAsAccount": "user",
"enforceSignatureCheck": true,
"fileName": "File Name value",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"runAs32Bit": true
}
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: 615
{
"@odata.type": "#microsoft.graph.deviceManagementScript",
"id": "59ea4525-4525-59ea-2545-ea592545ea59",
"displayName": "Display Name value",
"description": "Description value",
"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
}