Partager via

Guide pratique pour gérer les paramètres de télémétrie pour les commandes de code CLI Power Platform

Les commandes CLI Power Platform (PAC CLI) code collectent des données de télémétrie limitées pour aider Microsoft à améliorer la fiabilité, les performances et la facilité d’utilisation. Cette section explique ce qui est collecté, comment il circule et comment vous pouvez le contrôler.

Note

Cette section fait référence aux paramètres de télémétrie des commandes Power Platform CLIcode, et non aux données de télémétrie collectées lorsque votre application de code est exécutée. En savoir plus sur l’interface CLI Power Platform ici : Interface CLI Microsoft Power Platform

Pourquoi activer la télémétrie ?

Lorsque la télémétrie est activée, l’interface CLI Power Platform envoie les informations suivantes :

  • Événements d’activité : actions de haut niveau telles que l’exécution de commandes ou l’exécution de scénarios (par exemple, génération de fichiers de modèle et de service, sélection de l’environnement).
  • Événements d’erreur : échecs et exceptions (échecs de commande, erreurs inattendues), y compris les noms d’erreurs et les messages.
  • Minutage du scénario : démarrage/arrêt des flux clés, temps écoulé pour l’analyse des performances.
  • Contexte de l’environnement : métadonnées non-PII relatives à l’environnement et à la région (par exemple, région, géo, cluster), utilisées pour acheminer correctement les données de télémétrie.
  • Identificateur de locataire (le cas échéant) : si l’interface CLI s’est correctement authentifiée, l’ID de locataire actuel est attaché pour les diagnostics et l’agrégation.

Note

Les échecs de télémétrie ne bloquent jamais les opérations CLI.

Basculement des données de télémétrie

Les commandes PAC telemetry vous permettent de gérer les paramètres de télémétrie pour toutes les opérations PAC CLI. Ces modifications sont conservées entre les exécutions.

code télémétrie spécifique aux commandes

À compter de la version 1.51.1 de l’interface CLI Power Platform publiée en décembre 2025, vous pouvez gérer les données de télémétrie pour les code commandes, sans affecter d’autres commandes PAC CLI.

Les paramètres configurables par l’utilisateur sont stockés dans un userSettings.json fichier JSON sous le répertoire de configuration CLI nommé .powerapps-cli.

Le contenu du userSettings.json fichier a trois propriétés :

{
  "enabled": true,
  "consoleOnly": false,
  "outputToConsole": false
}

Le .powerapps-cli dossier se trouve à l’emplacement désigné par la variable d’environnement USERPROFILE .

Vous pouvez créer ce fichier manuellement ou utiliser le script PowerShell suivant :

$settingsPath = Join-Path $env:USERPROFILE ".powerapps-cli\userSettings.json"
$settingsDir = Split-Path $settingsPath
if (-not (Test-Path $settingsDir)) { New-Item -ItemType Directory -Path $settingsDir -Force }
$settings = @{
    enabled = $true
    consoleOnly = $false
    outputToConsole = $false
}
$settings | ConvertTo-Json | Set-Content $settingsPath

L’objectif de ces propriétés booléennes est décrit dans le tableau suivant :

Propriété Descriptif
enabled Indique si la télémétrie distante est activée.
consoleOnly Indique s’il faut enregistrer uniquement les données de télémétrie dans la console et ne jamais les envoyer à distance.
outputToConsole Faut-il également rediriger les événements de télémétrie vers la console ?

Note

Si vous avez désactivé la télémétrie globalement pour l’interface CLI PAC à l’aide des commandes PACtelemetry, la code commande n’envoie pas de données de télémétrie, même si vous l’activez pour la code commande.

Les sections suivantes décrivent les combinaisons valides de valeurs et leurs résultats :

Télémétrie activée, distante uniquement (valeur par défaut)

Si aucun fichier userSettings.json n’existe, voici le comportement. Aucune télémétrie n’est imprimée dans la console.

{
  "enabled": true,
  "consoleOnly": false,
  "outputToConsole": false
}

Télémétrie entièrement désactivée

{
  "enabled": false,
  "consoleOnly": false,
  "outputToConsole": false
}

Définissez outputToConsole sur true si vous souhaitez toujours voir les événements.

Télémétrie activée, distante + console

Les événements sont envoyés à distance. Les mêmes événements sont également imprimés localement.

{
  "enabled": true,
  "consoleOnly": false,
  "outputToConsole": true
}

Télémétrie console uniquement (pas d’envoi distant)

Quand consoleOnly la valeur est vraie, seule la journalisation de la console est utilisée. Aucune télémétrie n’est envoyée en externe, tout reste dans votre terminal.

{
  "enabled": false,
  "consoleOnly": true,
  "outputToConsole": false
}
  • enabled est effectivement ignoré pour l’envoi à distance.
  • outputToConsole n’est pas obligatoire ; la journalisation de la console est implicite.

Rediriger la télémétrie vers un fichier

Lorsque la télémétrie est configurée pour générer une sortie vers la console (à l’aide consoleOnly: true ou outputToConsole: true), vous pouvez rediriger la sortie vers un fichier. Cela est particulièrement utile pour capturer les journaux d’activité pour le débogage ou les demandes de support.

Invite de commandes Windows

Utilisez l’opérateur > pour rediriger stdout et 2>&1 pour inclure stderr si nécessaire.

pac code add-data-source .... > telemetry.log 2>&1

PowerShell (Windows, macOS, Linux)

Utilisez le cmdlet Out-File ou les opérateurs de redirection.

pac code add-data-source .... | Out-File -FilePath telemetry.log -Encoding utf8
  • Last updated on