Graph CLI parancsreferencia
A parancsokat az Architecture/GraphSyncExperimenter/cli-graph mappából futtasd. Először végezd el a CLI-beállítást és a Graph-alkalmazás jogosultságainak beállítását. Minden írási művelet valódi postafiókot céloz.
Parancsok
| Parancs | Művelet |
|---|---|
user lookup | Címtárfelhasználó feloldása cím alapján |
email list | Üzenetek listázása |
email get | Egy üzenet olvasása |
email attachments | Üzenetmellékletek megvizsgálása |
email send | Új üzenet küldése |
email reply, email reply-all, email forward | A megfelelő válasz létrehozása és elküldése |
email wait | A megfelelő címzetti másolatra várakozás |
email read | Üzenet megjelölése olvasottként |
email move | Üzenet áthelyezése |
email label add, email label remove | Outlook-kategória hozzáadása vagy eltávolítása |
email delete | Üzenet áthelyezése a Törölt elemek mappába |
email permanent-delete | Üzenet végleges törlése |
folder list, folder get | A fa listázása vagy egy mappa olvasása |
folder create, folder update, folder move, folder delete | Mappa létrehozása, átnevezése, áthelyezése vagy törlése |
label list, label get | Outlook-főkategóriák listázása vagy olvasása |
label create, label update, label delete | Kategória létrehozása, színének módosítása vagy törlése |
Azonosítók és bemenetek
A --user-id a célpostafiók Graph-objektumazonosítóját vagy felhasználói főnevét (UPN) jelöli. Küldésnél ez azonosítja a feladót. Nincs külön, hamisítható --from kapcsoló.
Az üzenetműveletekhez az adott postafiók változatlan üzenetazonosítója kell. Az internetMessageId köti össze a másolatokat a postafiókok között. A feladó emailId értéke nem címezheti a címzett másolatát.
A mappahivatkozás pontos azonosítót vagy egyedi, teljes megjelenített nevet fogad el. A nevek kis- és nagybetű-érzéketlenül egyeznek, nem részleges egyezéssel. A kétértelmű egyezéshez explicit azonosító kell. Az ismert értékek, például az inbox, azonosítóbemenetként működnek.
A küldéshez legalább egy --to, nem üres --subject és --body, valamint --priority low|normal|high szükséges. Több címzettnél ismételd a --to, --cc és --bcc kapcsolókat. A --body-type értéke html vagy text, alapértelmezés a html. A támogatott küldési és válaszparancsok ismételt --attachment fájlbemenetet fogadnak.
Az email wait alapértelmezett időkorlátja 60000 ms, lekérdezési időköze 2000 ms. A pozitív --timeout-ms és --poll-interval-ms értékek felülírják ezeket. Mappaszűrő nélkül a célpostafiókban keres.
Az email permanent-delete, a folder delete és a label delete parancsokhoz --confirm kell. Ez engedélyez egy valódi, visszafordíthatatlan műveletet. A végleges üzenettörlés a Törölt elemek mappában lévő üzenetekre vonatkozik. Küldési időtúllépés után új küldés előtt ellenőrizd az elküldötteket.
Példák
Cseréld le a mintacímeket, azonosítókat és tartalmat a saját, engedélyezett célpontjaidra. Az írási példák valódi postafiók-állapotot módosítanak. A pontos aktuális parancsszerkezetet a bun run cli -- --help parancs adja meg.
bun run cli -- <resource> <action> \
--user-id <graph-user-id-or-upn> \
[command-specific-options]
bun run cli -- --help
bun run cli -- email list \
--user-id tatar.bela@t42.hu
bun run cli -- email list \
--user-id tatar.bela@t42.hu \
--folder-id AAMkAG...
bun run cli -- email list \
--user-id tatar.bela@t42.hu \
--folder-id inbox
bun run cli -- email list \
--user-id tatar.bela@t42.hu \
--folder-name "Customer Follow-up"
bun run cli -- email send \
--user-id tatar.bela@t42.hu \
--to recipient@example.com \
--cc copy@example.com \
--bcc hidden@example.com \
--subject "Graph synchronization test" \
--body "<p>Test message</p>" \
--body-type html \
--priority normal
bun run cli -- email wait \
--user-id tatar.bela@t42.hu \
--internet-message-id "<message-id@example.com>" \
--timeout-ms 120000 \
--poll-interval-ms 2000
bun run cli -- email wait \
--user-id tatar.bela@t42.hu \
--internet-message-id "<message-id@example.com>" \
--folder-name "Incoming Tests"
bun run cli -- email read \
--user-id tatar.bela@t42.hu \
--immutable-email-id IMMUTABLE_ID
bun run cli -- email move \
--user-id tatar.bela@t42.hu \
--immutable-email-id IMMUTABLE_ID \
--target archive
bun run cli -- email move \
--user-id tatar.bela@t42.hu \
--immutable-email-id IMMUTABLE_ID \
--target AAMkAG...
bun run cli -- email move \
--user-id tatar.bela@t42.hu \
--immutable-email-id IMMUTABLE_ID \
--target "Customer Follow-up"
bun run cli -- email label add \
--user-id tatar.bela@t42.hu \
--immutable-email-id IMMUTABLE_ID \
--label-id LABEL_ID
bun run cli -- email label add \
--user-id tatar.bela@t42.hu \
--immutable-email-id IMMUTABLE_ID \
--label-name "Important"
bun run cli -- email label remove \
--user-id tatar.bela@t42.hu \
--immutable-email-id IMMUTABLE_ID \
--label-name "Important"
bun run cli -- email delete \
--user-id tatar.bela@t42.hu \
--immutable-email-id IMMUTABLE_ID
bun run cli -- email permanent-delete \
--user-id tatar.bela@t42.hu \
--immutable-email-id IMMUTABLE_ID \
--confirm
bun run cli -- folder list \
--user-id tatar.bela@t42.hu
bun run cli -- folder get \
--user-id tatar.bela@t42.hu \
--folder-id FOLDER_ID
bun run cli -- folder create \
--user-id tatar.bela@t42.hu \
--name "Graph Tests"
bun run cli -- folder create \
--user-id tatar.bela@t42.hu \
--name "Completed" \
--parent-folder-id PARENT_FOLDER_ID
bun run cli -- folder update \
--user-id tatar.bela@t42.hu \
--folder-id FOLDER_ID \
--name "New folder name"
bun run cli -- folder move \
--user-id tatar.bela@t42.hu \
--folder-id FOLDER_ID \
--target-folder-id TARGET_PARENT_FOLDER_ID
bun run cli -- folder delete \
--user-id tatar.bela@t42.hu \
--folder-id FOLDER_ID \
--confirm
bun run cli -- label list \
--user-id tatar.bela@t42.hu
bun run cli -- label get \
--user-id tatar.bela@t42.hu \
--label-id LABEL_ID
bun run cli -- label create \
--user-id tatar.bela@t42.hu \
--name "Graph Tested" \
--color preset4
bun run cli -- label update \
--user-id tatar.bela@t42.hu \
--label-id LABEL_ID \
--color preset8
bun run cli -- label delete \
--user-id tatar.bela@t42.hu \
--label-id LABEL_ID \
--confirm
bun run cli -- user lookup --address person@example.com
bun run cli -- email get --user-id person@example.com --immutable-email-id MESSAGE_ID
bun run cli -- email reply --user-id person@example.com --immutable-email-id MESSAGE_ID --to sender@example.com --body 'Reply text'
bun run cli -- email reply-all --user-id person@example.com --immutable-email-id MESSAGE_ID --to sender@example.com --cc colleague@example.com --body 'Reply to everyone'
bun run cli -- email forward --user-id person@example.com --immutable-email-id MESSAGE_ID --to colleague@example.com --body 'Forwarding for review'
A kilépési kódokat és a provider-hibákat a kimenetek és hibaelhárítás oldal írja le.