Pide tu presupuesto ya!

Cargue un script de PowerShell en Intune (con PowerShell) desde cero

Si tiene Intune en su organización con algunos scripts de PowerShell que necesita ejecutar en máquinas remotas, este tutorial es para usted.

Abordemos un proyecto en el que cubriremos todo, desde la automatización de la creación de un registro de aplicación de Azure, la generación de un secreto de cliente, la obtención de un token API de Microsoft Graph y el uso de ese token para implementar un script de administración de dispositivos. Puede parecer mucho, pero créeme, ¡te guiaré paso a paso!

Paso 1: instalar los módulos necesarios y autenticarse en Azure

Lo primero es lo primero, debemos instalar los módulos de PowerShell necesarios y autenticarnos en Azure. Este es un paso crucial porque sin los módulos correctos y la autenticación adecuada, nada más funcionará. Abra su consola PowerShell y ejecute los siguientes comandos:

# Install necessary Azure PowerShell modules
Install-Module 'Az.Resources', 'Az.Accounts'

# Authenticate to Azure
Connect-AzAccount

Cuando ejecute estos comandos, se le pedirá que inicie sesión en su cuenta de Azure. Siga las instrucciones, ingrese sus credenciales y estará listo.

Paso 2: definir el acceso a los recursos necesarios

A continuación, debemos definir el acceso a los recursos que necesitará el registro de nuestra aplicación. Específicamente, necesitamos acceder a la API de Microsoft Graph con ciertos permisos. Definiremos estos permisos en una tabla hash de PowerShell. Esta tabla incluye ResourceAppId, que es el ID de Microsoft Graph, y ResourceAccess, que especifica los permisos que necesitará nuestra aplicación. Así es como se ve:

# Define required resource access
$requiredResourceAccess = @(
    @{
        ResourceAppId  = "00000003-0000-0000-c000-000000000000"  # Microsoft Graph API ID
        ResourceAccess = @(
            @{
                Id   = "9241abd9-d0e6-425a-bd4f-47ba86e767a4"     # DeviceManagementConfiguration.ReadWrite.All permission ID
                Type = "Role"
            }
        )
    }
)

Paso 3: cree el registro de la aplicación

Ahora que hemos definido el acceso a los recursos requerido, creemos el registro de la aplicación. Básicamente, este registro le dice a Azure AD que queremos crear una nueva aplicación con los permisos especificados. Ejecute el siguiente comando:

$app = New-AzADApplication -DisplayName DeviceManagementScriptApp -RequiredResourceAccess $requiredResourceAccess

Este comando registrará una nueva aplicación en Azure AD con los permisos especificados. El $app La variable ahora contiene los detalles de la aplicación recién creada.

Paso 4: generar un secreto de cliente

A continuación, necesitamos generar un secreto de cliente para el registro de nuestra aplicación. Piense en esto como una contraseña para su aplicación que le permite autenticarse y acceder a recursos de forma segura. Así es como lo haces:

$secret = New-AzADAppCredential -ObjectId $app.Id

Este comando crea un secreto de cliente, que usaremos más adelante cuando realicemos llamadas a la API. Es fundamental almacenar este secreto de forma segura porque actúa como una contraseña para su aplicación.

Paso 5: Obtenga un token API de Microsoft Graph

Ahora, necesitamos crear una función para obtener un token API de Microsoft Graph usando las credenciales de nuestra aplicación. Los tokens son esenciales para demostrar nuestra identidad al llamar a la API. La siguiente función nos ayudará a obtener este token:

function getGraphApiToken {
    param (
        [string]$TenantId,
        [string]$ClientId,
        [string]$ClientSecret
    )

    $body = @{
        grant_type    = "client_credentials"
        scope         = "https://graph.microsoft.com/.default"
        client_id     = $ClientId
        client_secret = $ClientSecret
    }

    $tokenResponse = Invoke-RestMethod -Uri "https://login.microsoftonline.com/$TenantId/oauth2/v2.0/token" -Method Post -Body $body -ContentType "application/x-www-form-urlencoded"
    $tokenResponse.access_token
}

# Example usage
$TenantId = "<Your-Tenant-ID>"
$ClientId = $app.ApplicationId
$ClientSecret = $secret.SecretText
$token = getGraphApiToken -TenantId $TenantId -ClientId $ClientId -ClientSecret $ClientSecret

Esta función envía una solicitud al punto final del token de Azure AD para obtener un token de acceso. El Invoke-RestMethod El comando es clave aquí, ya que maneja la solicitud HTTP POST y devuelve el token de acceso que necesitamos para futuras llamadas API.

Paso 6: preparar el contenido del guión

Pasemos a preparar el contenido del script de PowerShell que queremos implementar. Este script se codificará en formato base64 porque Graph API espera el contenido del script en este formato. Así es como lo haces:

# Define the script content
$someScriptContent = @'
## This is some PowerShell script
Test-Path C:
'@

# Encode the script content to base64
$base64ScriptContent = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($someScriptContent))

Primero definimos el contenido de nuestro script y luego lo convertimos a una cadena codificada en base64, asegurándonos de que esté formateado correctamente para la transmisión a través de Graph API.

Paso 7: cree el cuerpo HTTP para la llamada REST

A continuación, preparemos el cuerpo HTTP para la llamada REST a Graph API. Esto incluye configurar los encabezados y el cuerpo de nuestra solicitud. Los encabezados contendrán el token de autorización y el cuerpo incluirá detalles sobre el script, como su contenido e idioma:

# Prepare the headers with the token
$headers = @{
    Authorization  = "Bearer $token"
    'Content-Type' = 'application/json'
}

# Create the HTTP body for the REST call
$body = @{
    "@odata.type"           = "#microsoft.graph.deviceManagementScript"
    "scriptContent"         = $base64ScriptContent
    "scriptLanguage"        = "PowerShell"
    "displayName"           = "Example Script"
    "description"           = "This is an example script."
    "runAsUser"             = "system"
    "runAs32Bit"            = $false
    "enforceSignatureCheck" = $false
}

Paso 8: realice la llamada API

Finalmente, configuremos los parámetros para la llamada a la API REST y ejecutémosla. Este paso implica realizar una solicitud POST al punto final de Graph API para implementar nuestro script de administración de dispositivos.

powershellCopy code
# Set up the params for the REST API call
$irmParams = @{
    Uri                = 'https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts'
    Method             = 'POST'
    Headers            = $headers
    StatusCodeVariable = 'respStatus'
    SkipHttpErrorCheck = $true
    Body               = ($body | ConvertTo-Json)
}

# Make the API call
$response = Invoke-RestMethod @irmParams

# Handle any errors
if ($respStatus -ne 201) {
    throw $response.error.message
} else {
    Write-Output "Script deployed successfully!"
}

Este bloque de código configura los parámetros para el Invoke-RestMethod comando, que envía el contenido de nuestro script al punto final de Graph API especificado. El StatusCodeVariable captura el código de estado de respuesta para verificar si nuestra solicitud fue exitosa. Si todo va bien, verá «¡El script se implementó correctamente!». impreso.

¡Y ahí lo tienes! Ha automatizado con éxito el proceso de creación de un registro de aplicación de Azure, generando un secreto de cliente, obteniendo un token de API de Microsoft Graph e implementando un script de administración de dispositivos. Este potente flujo de trabajo le permite administrar los recursos de Azure de manera eficiente y segura. No dude en personalizar el script y los parámetros para adaptarlos a sus necesidades específicas. ¡Feliz guión!

Written by

Leave a comment