Teilen über

Vorgehensweise: Telemetrieeinstellungen für die Power Platform CLI-Codebefehle verwalten

Die Power Platform CLI -Befehle (PAC CLI) code sammeln eingeschränkte Telemetrie, um Microsoft dabei zu helfen, Zuverlässigkeit, Leistung und Benutzerfreundlichkeit zu verbessern. In diesem Abschnitt wird erläutert, was gesammelt wird, wie sie fließt und wie Sie sie steuern können.

Hinweis

Dieser Abschnitt bezieht sich auf die Telemetrieeinstellungen für die Power Platform CLI-Befehle code und nicht auf die Telemetrie, die erfasst wird, wenn Ihre Code-App wiedergegeben wird. Erfahren Sie mehr über die Power Platform CLI hier: Microsoft Power Platform CLI

Warum Telemetrie aktivieren?

Wenn Telemetrie aktiviert ist, sendet die Power Platform CLI die folgenden Informationen:

  • Aktivitätsereignisse – Aktionen auf hoher Ebene wie das Ausführen von Befehlen oder das Abschließen von Szenarien (z. B. Modell- und Dienstdateiengenerierung, Umgebungsauswahl).
  • Fehlerereignisse – Fehler und Ausnahmen (Befehlsfehler, unerwartete Fehler), einschließlich Fehlernamen und Meldungen.
  • Szenario-Timing – Start/Stop der Schlüsselabläufe mit verstrichener Zeit für die Leistungsanalyse.
  • Umgebungskontext – Nicht-PII-Metadaten zu Umgebung und Region (z. B. Region, Geo, Cluster), die zum ordnungsgemäßen Weiterleiten von Telemetrie verwendet werden.
  • Mandanten-ID (sofern verfügbar) – Wenn die CLI erfolgreich authentifiziert wurde, wird die aktuelle Mandanten-ID für Diagnose und Aggregation angefügt.

Hinweis

Telemetriefehler blockieren nie CLI-Vorgänge.

Umschalten der Telemetrie

Mit den PAC-Befehlen telemetry können Sie Telemetrieeinstellungen für alle PAC-CLI-Vorgänge verwalten. Diese Änderungen werden über mehrere Durchläufe hinweg beibehalten.

code Befehlsspezifische Telemetrie

Ab Version 1.51.1 der Power Platform CLI, die im Dezember 2025 veröffentlicht wurde, können Sie Telemetrie für die code Befehle verwalten, ohne dass sich dies auf andere PAC CLI-Befehle auswirkt.

Die vom Benutzer konfigurierbaren Einstellungen werden in einer userSettings.json JSON-Datei unter dem CLI-Konfigurationsverzeichnis mit dem Namen .powerapps-cligespeichert.

Der userSettings.json Dateiinhalt verfügt über drei Eigenschaften:

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

Der .powerapps-cli Ordner befindet sich an dem Von der USERPROFILE Umgebungsvariablen festgelegten Speicherort.

Sie können diese Datei manuell erstellen oder das folgende PowerShell-Skript verwenden:

$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

Der Zweck dieser booleschen Eigenschaften wird in der folgenden Tabelle beschrieben:

Eigentum Description
enabled Gibt an, ob die Remote-Telemetrie aktiviert ist.
consoleOnly Gibt an, ob nur Telemetrie an der Konsole protokolliert und nie remote gesendet werden soll.
outputToConsole Gibt an, ob Telemetrieereignisse zusätzlich in die Konsole gespiegelt werden sollen.

Hinweis

Wenn Sie die Telemetrie global für die PAC-CLI mithilfe der PAC-Befehle telemetrydeaktiviert haben, sendet der code Befehl keine Telemetrie, auch wenn Sie sie für den code Befehl aktivieren.

In den folgenden Abschnitten werden gültige Wertekombinationen und deren Ergebnisse beschrieben:

Telemetrie aktiviert, nur Fernzugriff (Standard)

Wenn keine userSettings.json Datei vorhanden ist, ist dies das Verhalten. Es wird keine Telemetrie in der Konsole ausgegeben.

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

Telemetrie vollständig deaktiviert

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

Legen Sie outputToConsole auf true fest, wenn Sie weiterhin Ereignisse anzeigen möchten.

Telemetrie aktiviert, Remote+ Konsole

Ereignisse werden remote gesendet. Dieselben Ereignisse werden auch lokal gedruckt.

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

Nur-Konsolen-Telemetrie (keine Remotenachricht)

Wenn consoleOnly wahr ist, wird nur Konsolen-Logging verwendet. Keine Telemetrie wird extern gesendet, alles bleibt in Ihrem Terminal.

{
  "enabled": false,
  "consoleOnly": true,
  "outputToConsole": false
}
  • enabled wird für das Remote-Senden effektiv ignoriert.
  • outputToConsole ist nicht erforderlich; die Konsolenprotokollierung wird impliziert.

Telemetrie-Daten in eine Datei umleiten

Wenn Telemetrie so konfiguriert ist, dass sie in die Konsole ausgegeben wird (mit consoleOnly: true oder outputToConsole: true), können Sie die Ausgabe an eine Datei umleiten. Dies ist besonders hilfreich beim Erfassen von Protokollen für Debugging- oder Supportanfragen.

Windows-Eingabeaufforderung

Verwenden Sie den > Operator, um stdout und 2>&1 umzuleiten und bei Bedarf stderr einzuschließen.

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

PowerShell (Windows, macOS, Linux)

Verwenden Sie das Cmdlet Out-File oder die Umleitungsoperatoren.

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