# Microsoft 365 通过 Microsoft 365 的 CLI 此技能使用“m365”CLI（适用于 Microsoft 365 的 CLI）通过 Microsoft Graph API 与 Outlook 电子邮件和日历进行交互。它可以跨平台运行（macOS、Linux、Windows）。 ## 连接检查在执行任何操作之前，请并行运行这两个命令： m365 状态--输出 json m365连接列表--输出json 如果活动连接已具有 `"authType": "secret"`，请继续执行该任务。如果活动连接具有不同的身份验证类型（例如“deviceCode”），请使用“authType”：“secret”检查“连接列表”以查找非活动连接。如果存在，则激活它： m365 连接使用 --name "<连接名称>" 仅当根本不存在“秘密”连接时，才读取“./setup.md”（相对于此文件）并按照设置步骤操作。所有以用户邮箱为目标的命令都需要“--userName ”（内置命令）或 Graph API URL 中的用户主体名称。如果不知道，请询问用户的 UPN（例如“user@company.com”）。 ## 重要提示 * 在任何写入操作（发送电子邮件、创建/删除事件）之前始终与用户确认。 * CLI 具有用于电子邮件的内置命令，但不具有用于日历事件的内置命令。将“m365 请求”与 Graph API URL 结合使用以进行日历操作。 * 使用 `--output json` 获得机器可读的输出。使用 `--query` (JMESPath) 来过滤字段。 * 每个命令都支持 `-h` / `--help`。使用 `m365 --help` 来发现命令。 ## 电子邮件 ### 列出消息 m365 Outlook 邮件列表 --folderName inbox --userName --output json # 包含日期范围（endTime 必须是过去的时间） m365 Outlook 邮件列表 --folderName inbox --userName \ --startTime "2026-02-01T00:00:00Z" --endTime "2026-02-15T00:00:00Z" --输出 json # 使用 JMESPath 压缩输出 m365 Outlook 邮件列表 --folderName inbox --userName --output json \ --query "[].{subject:subject,from:from.emailAddress.address,received:receivedDateTime,isRead:isRead}" 文件夹名称：“收件箱”、“草稿”、“sentitems”、“deleteditems”、“junkemail”、“archive”。您还可以使用“--folderId”。 ### 阅读特定消息 m365 Outlook 消息获取 --id <消息 ID> --userName --输出 json ### 搜索电子邮件（通过 Graph API）内置的“消息列表”不支持搜索。将“m365 request”与“$search”或“$filter”一起使用： # 全文搜索（主题、正文、发件人等） m365 请求 --url "https://graph.microsoft.com/v1.0/users//messages?\$search=%22keyword%22&\$select=subject,from,receivedDateTime&\$top=10" --method get --output json # 按发件人过滤 m365 请求 --url "https://graph.microsoft.com/v1.0/users//messages?\$filter=from/emailAddress/address eq 'someone@example.com'&\$select=subject,receivedDateTime&\$top=10" --method get --output json 注意：`$search` 和 `$orderby` 不能组合使用。 “$search”的结果按相关性排名。 ### 列出邮件文件夹 m365 请求 --url "https://graph.microsoft.com/v1.0/users//mailFolders?\$select=displayName,id,totalItemCount,unreadItemCount" --method get --output json ### 发送电子邮件 # 纯文本 m365 Outlook 邮件发送 --subject "主题" --to "recipient@example.com" \ --sender "" --bodyContents "消息正文" --output json # 具有多个收件人的 HTML m365 Outlook 邮件发送 --subject "主题" --to "a@example.com,b@example.com" \ --cc "c@example.com" --sender "" \ --bodyContents "

HTML 正文

" --bodyContentType HTML --输出 json # 带附件（每个附件最大 3 MB） m365 Outlook 邮件发送 --subject "主题" --to "recipient@example.com" \ --sender "" --bodyContents "参见附件。" \ --附件“/path/to/file.pdf”--输出json # 从共享邮箱发送 m365 Outlook 邮件发送 --subject "主题" --to "recipient@example.com" \ --邮箱“shared@company.com”--发件人“”\ --bodyContents "从共享邮箱发送" --output json ### 回复电子邮件（通过 Graph API） CLI 没有内置回复命令。将“m365请求”与Graph API回复端点结合使用： # 仅回复发件人（纯文本评论）猫 > /tmp/m365_reply.json << 'EOF' { “comment”：“谢谢，这对我有用！” } EOF m365 请求 --url "https://graph.microsoft.com/v1.0/users//messages//reply" \ --方法帖子--body @/tmp/m365_reply.json --内容类型“application/json” # 全部回复 m365 请求 --url "https://graph.microsoft.com/v1.0/users//messages//replyAll" \ --方法帖子--body @/tmp/m365_reply.json --内容类型“application/json” # 使用 HTML 正文和其他收件人进行回复猫 > /tmp/m365_reply.json << 'EOF' { “消息”：{ “致收件人”：[ {"emailAddress": {"address": "extra@example.com", "name": "额外收件人"}} ] }, "comment": "

使用 HTML 内容回复。

" } EOF m365 请求 --url "https://graph.microsoft.com/v1.0/users//messages//reply" \ --方法帖子--body @/tmp/m365_reply.json --内容类型“application/json” Graph API 处理线程、引用原始消息并自动设置收件人。使用“comment”作为回复文本。可以选择包含“消息”对象来添加/覆盖收件人。返回“202 Accepted”，没有成功的正文。需要“邮件.发送”权限。 ### 移动/存档消息 m365 Outlook 消息移动 --id <消息 ID> \ --sourceFolderName 收件箱 --targetFolderName 存档 --output json ## 日历日历操作将“m365 请求”与 Microsoft Graph API 端点结合使用。对于 POST/PUT/PATCH 请求，将 JSON 正文写入临时文件并使用 `--body @/path/to/file.json --content-type "application/json"` 传递。 ### 列出日历 m365 请求 --url "https://graph.microsoft.com/v1.0/users//calendars?\$select=name,id,canEdit,isDefaultCalendar" --method get --output json ### 列出即将发生的事件（日历视图）对日期范围内的事件使用“calendarView”（扩展重复事件）： m365 请求 --url "https://graph.microsoft.com/v1.0/users//calendarView?\$select=subject,start,end,location,organizer,isAllDay&startDateTime=2026-02-17T00:00:00Z&endDateTime=2026-02-24T00:00:00Z&\$orderby=start/dateTime" --方法获取--输出json ### 获取活动详细信息（与与会者一起） m365 请求 --url "https://graph.microsoft.com/v1.0/users//events/?\$select=subject,start,end,location,organizer,attendees,body,onlineMeeting" --method get --output json ### 搜索事件 m365 请求 --url "https://graph.microsoft.com/v1.0/users//events?\$filter=contains(subject,'keyword')&\$select=subject,start,end&\$top=10" --method get --output json ### 创建事件将事件 JSON 写入临时文件，然后 POST：猫 > /tmp/m365_event.json << 'EOF' { "subject": "会议标题", "start": {"dateTime": "2026-03-01T14:00:00", "timeZone": "欧洲/柏林"}, "end": {"dateTime": "2026-03-01T15:00:00", "timeZone": "欧洲/柏林"}, "location": {"displayName": "会议室"}, “与会者”：[ {"emailAddress": {"address": "attendee@example.com", "name": "姓名"}, "type": "必填"} ], "body": {"contentType": "text", "content": "议程: ..."} } EOF m365 请求 --url "https://graph.microsoft.com/v1.0/users//events" \ --method post --body @/tmp/m365_event.json --content-type "application/json" --output json ### 删除事件 m365 请求 --url "https://graph.microsoft.com/v1.0/users//events/" \ --删除方法 ## 提示 * 分页结果包括`@odata.nextLink`。通过将该 URL 传递给“m365 request”来获取下一页。 * 使用 `--query` (JMESPath) 提取特定字段：`--query "[].{subject:subject,from:from.emailAddress.address}"`。 * 对于 Graph API 请求，请使用 `\$` 在 shell 中转义 `$`。 * `$top` 限制结果：`$top=5` 最多返回 5 项。 * 图形 API 日期时间为 UTC。在事件开始/结束时指定“timeZone”为当地时间。

m365

包含技能