Criar deviceManagementScript
Namespace: microsoft.graph
Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Crie um novo objeto deviceManagementScript .
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.
Tipo de permissão | Permissões (de privilégios máximos a mínimos) |
---|---|
Delegado (conta corporativa ou de estudante) | |
Gerenciamento de dispositivo | DeviceManagementConfiguration.ReadWrite.All |
Conjunto de Políticas | DeviceManagementConfiguration.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Application | |
Gerenciamento de dispositivo | DeviceManagementConfiguration.ReadWrite.All |
Conjunto de Políticas | DeviceManagementConfiguration.ReadWrite.All |
Solicitação HTTP
POST /deviceManagement/deviceManagementScripts
Cabeçalhos de solicitação
Cabeçalho | Valor |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Aceitar | application/json |
Corpo da solicitação
No corpo do pedido, forneça uma representação JSON para o objeto deviceManagementScript.
A tabela seguinte mostra as propriedades necessárias quando cria o deviceManagementScript.
Propriedade | Tipo | Descrição |
---|---|---|
id | Cadeia de caracteres | Identificador Exclusivo para o script de gestão de dispositivos. |
displayName | Cadeia de caracteres | Nome do script de gestão de dispositivos. |
description | Cadeia de caracteres | Descrição opcional para o script de gestão de dispositivos. |
scriptContent | Binária | O conteúdo do script. |
createdDateTime | DateTimeOffset | A data e hora em que o script de gestão de dispositivos foi criado. Essa propriedade é somente leitura. |
lastModifiedDateTime | DateTimeOffset | A data e hora em que o script de gestão de dispositivos foi modificado pela última vez. Essa propriedade é somente leitura. |
runAsAccount | runAsAccountType | Indica o tipo de contexto de execução. Os valores possíveis são: system e user . |
enforceSignatureCheck | Booliano | Indique se a assinatura do script precisa de ser verificada. |
fileName | Cadeia de caracteres | Nome do ficheiro de script. |
roleScopeTagIds | Coleção String | Lista de IDs de Etiquetas de Âmbito para esta instância do PowerShellScript. |
runAs32Bit | Booliano | Um valor que indica se o script do PowerShell deve ser executado como 32 bits |
Resposta
Se for bem-sucedido, este método devolve um 201 Created
código de resposta e um objeto deviceManagementScript no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
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",
"scriptContent": "c2NyaXB0Q29udGVudA==",
"runAsAccount": "user",
"enforceSignatureCheck": true,
"fileName": "File Name value",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"runAs32Bit": true
}
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 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",
"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
}