Verwalten von Telemetrieeinstellungen für die Power Apps CLI

In diesem Artikel wird erläutert, wie Sie Power Apps CLI-Telemetrieeinstellungen verwalten, damit Sie den aktuellen Status anzeigen, die Sammlung aktivieren oder deaktivieren und die Konsolenausgabe für das Debuggen oder die Unterstützung konfigurieren können.

Warum Telemetrie aktivieren?

Wenn Telemetrie aktiviert ist, kann die CLI Folgendes erfassen:

Telemetriedaten Beschreibung
Aktivitätsereignisse Allgemeine Aktionen, z. B. Ausführen von Befehlen oder Abschließen von Szenarien.
Fehlerereignisse Fehler und Ausnahmen, einschließlich Fehlernamen und Nachrichten.
Zeitpunkt des Szenarios Start- und Stoppereignisse für wichtige Vorgänge und deren verstrichene Zeit.
Umgebungskontext Nicht persönlich identifizierbare Metadaten zu Umgebung und Region.
Mandanten-ID Die aktuelle Mandanten-ID, wenn die CLI authentifiziert ist.

Hinweis

Telemetriefehler blockieren nie CLI-Vorgänge.

Verwalten von Telemetrie mit CLI-Befehlen

Verwenden Sie die folgenden Befehle zum Verwalten von Telemetrie:

Befehl Beschreibung
pa telemetry enable Telemetriesammlung aktivieren.
pa telemetry disable Telemetriesammlung deaktivieren.
pa telemetry status Zeigt die aktuellen Telemetrieeinstellungen an.

Beispiel:

pa telemetry disable
pa telemetry status

Diese Einstellungen bleiben über mehrere CLI-Ausführungen hinweg erhalten.

Konfigurieren der Konsolenausgabe

Die CLI speichert benutzerkonfigurierbare Einstellungen im userSettings.json.powerapps-cli Konfigurationsverzeichnis.

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

Sie können die 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

Die Datei unterstützt die folgenden Eigenschaften:

{
  "enabled": true,
  "consoleOnly": false,
  "outputToConsole": false
}
Eigenschaft Beschreibung
enabled Gibt an, ob die Remote-Telemetrie aktiviert ist.
consoleOnly Schreibt Telemetrie nur in die Konsole und sendet sie nicht remote.
outputToConsole Spiegelt remote gesendete Telemetrieereignisse an die Konsole.

Telemetrie aktiviert, nur Fernzugriff (Standard)

Wenn die Datei nicht vorhanden ist, ist die Remotetelemetrie aktiviert, und Telemetrie wird nicht in die Konsole geschrieben.

{
  "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 und Konsole

Das System sendet Ereignisse remote und druckt sie lokal.

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

Nur-Konsolen-Telemetrie (keine Remotenachricht)

Um Telemetrie in die Konsole zu schreiben, ohne sie remote zu senden, verwenden Sie Folgendes:

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

Pipe-Telemetrie an eine Datei

Wenn die Konsolenausgabe aktiviert ist, können Sie die Ausgabe eines Befehls wie pa app add data-source zur Fehlerbehebung oder für den Support in eine Datei umleiten.

Windows-Eingabeaufforderung

pa app add data-source ... > telemetry.log 2>&1

PowerShell (Windows, macOS, Linux)

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