Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
Agent 365 CLI-kommandoreference
Administrer CLI-diagnostiske logfiler. Kommandoen logs eksporterer redigerede kopier af CLI-logfiler, som er sikre at dele med Microsoft support. Brug underkommandoen logs export til at redigere og kopiere CLI-logfiler. De eksporterede filer er sikre at vedhæfte til en supportticket uden at lække e-mails, GUID'er eller tokens.
Minimumsrolle påkrævet: Ingen. Kommandoen læser og omskriver kun lokale logfiler.
Syntax
a365 logs [command] [options]
logs export
Eksporter en redigeret kopi af en CLI-diagnostisk logfil, som er sikker at dele med Microsoft support. Redigerer JWT-tokens, e-mailadresser, GUID'er og OS-sti-brugernavne og erstatter identiske værdier med konsistente aliaser, så logkorrelationen bevares.
a365 logs export [<command>] [options]
CLI'en skriver en diagnostisk logfil for hver topkommando til din lokale logmappe (for eksempel %LOCALAPPDATA%\Microsoft.Agents.A365.DevTools.Cli\logs\ på Windows).
logs export læser en eller alle disse filer, fjerner følsomt indhold og skriver de redigerede kopier til din valgte outputmappe.
Hvad bliver redigeret
| Pattern | Replacement |
|---|---|
| JWT-bærertokens (header.payload.signature) | <JWT-TOKEN> |
| Email addresses |
<email-1>, <email-2>, ... (konsistente aliaser pr. e-mail) |
| GUIDs (8-4-4-4-12) — se Hvad der bevares for undtagelser |
<id-1>, <id-2>, ... (konsistente aliaser ifølge GUID) |
OS-sti-brugernavne (C:\Users\<name>, /Users/<name>, ) /home/<name> |
<username-1>, <username-2>, ... |
Identiske værdier bevarer det samme alias i hele filen, så krydsreferencer i logbogen forbliver nyttige til at diagnosticere problemer. Den redigerede fil indeholder en header, der registrerer kildestien (med de samme redigeringer) og optællinger af hvert mønster, der blev udskiftet.
What's preserved
Redaktøren keeps følgende indhold ordret, så den redigerede log stadig er nyttig til fejlfinding og til Microsoft støtte for eskalering:
| Preserved | Hvorfor det er sikkert |
|---|---|
| Tidsstempler, logniveauer, scope-navne, fejlkoder, filstier (med brugernavne indsat), HTTP-statuskoder, JSON-former | Ingen af disse identificerer en lejer eller bruger. |
TraceId: <guid> og CorrelationId: <guid> værdier |
Sessionslokale tilfældige identifikatorer genereret af CLI'en. De er ikke følsomme, og det er dem, der parrer loggen mod serverside-spor. |
request-id og client-request-id værdier inde i Microsoft Graph fejllegemer |
Servergenereret pr. opkald. Microsoft support bruger disse til at slå den præcise anmodning op i servicelogfiler, når du eskalerer. |
| Offentlige, velkendte Microsoft- og Agent 365-ressourceapplikations-ID'er: • Microsoft Graph ( 00000003-0000-0000-c000-000000000000)• Agent 365 Messaging Bot API • Agent 365 Observability API • Power Platform API (Forbindelse) • Agent 365 Tools (MCP-publikum, produktion) |
Disse er dokumenterede offentlige konstanter — de afslører intet om din lejer. At bevare dem betyder, at en linje som Validated permission AgentIdentityBlueprint.ReadWrite.All against 00000003-0000-0000-c000-000000000000 forbliver læsbar i stedet for at blive ... against <id-4>. |
Lejerspecifikke serviceprincipal-objekt-ID'er og andre GUID'er, der ikke matcher ovenstående mønstre, er stadig redigeret gennem konsistent-alias-mekanismen.
Important
Redaktionsmønstrene er designet til at fjerne det mest almindelige følsomme indhold. Hvis dine logfiler indeholder brugerdefinerede hemmeligheder (for eksempel hemmeligheder logget af kode uden for denne CLI, eller værdier indsat i stack traces) i formater, som denne redaktør ikke genkender, så fjern dem manuelt, før du deler dem.
Sådan verificerer du før deling
Åbn den redigerede fil i en teksteditor og scan efter alt, der ser tenant-specifikt ud:
# Spot-check what was preserved vs aliased
Select-String -Path .\a365.setup.redacted.log -Pattern "CorrelationId|TraceId|request-id" | Select-Object -First 10
Select-String -Path .\a365.setup.redacted.log -Pattern "<id-|<email-|<JWT-TOKEN>|<username-" | Measure-Object
Den eksporterede fils headerlinje opsummerer optællingerne. Hvis du ser flere aliaser <id-N> , end du forventer, gør aliaskortet sit arbejde — hver lejerespecifik GUID får præcis ét alias.
export indstillinger
| Option | Description |
|---|---|
<command> |
Navnet på kommandoen, hvis log du vil eksportere (såsom setup eller cleanup). Udelad dette argument for at eksportere alle tilgængelige logfiler i ét gennemløb. |
-o, --output <output> |
Mappe til at skrive den redigerede logfil eller filer til. Som standard er den aktuelle mappe. |
-?, -h, --help |
Vis oplysninger om hjælp og brug. |
Examples
Eksporter loggen setup til den aktuelle mappe:
a365 logs export setup
Eksporter alle tilgængelige logfiler til en bestemt mappe:
a365 logs export --output ./support-bundle
Eksporter loggen cleanup til en specifik mappe:
a365 logs export cleanup --output ./support-bundle
Navngivning af outputfiler
Den eksporterede fil skrives som a365.<command>.redacted.log. Når du udelader <command>, eksporterer CLI hver tilgængelig log til sin egen redigerede fil med samme navngivningsmønster.
Important
Gennemgå den redigerede fil, før du deler den. Redaktionsmønstrene dækker JWT-tokens, e-mails, GUIDs og OS-sti-brugernavne, men de dækker ikke alle mulige hemmeligheder. Hvis din log indeholder brugerdefinerede hemmeligheder eller følsomme identifikatorer i andre formater, skal du fjerne dem manuelt, før du deler dem.
Note
logs export Sletter eller ændrer ikke de oprindelige logfiler. De oprindelige logfiler forbliver i din lokale logmappe. Kommandoen skriver kun redigerede kopier til outputmappen.