360 Secure SkillHub
360 安全技能中心

Skill

提供对 PnP CLI for Microsoft 365 的封装说明：安装 npm 包后可通过 m365 命令登录并管理微软云服务。覆盖 SharePoint Online、Teams、OneDrive、Outlook、Planner、Entra ID 等负载，支持设备码等多种认证方式，输出 JSON 或文本并用 JMESPath 过滤。多数命令需先登录，使用前建议先调用帮助命令。

thomyg
thomyg
热度 79.10
最近更新 2026-05-11 17:25:56
分类：自动化依赖：代码执行 / 第三方 API应用场景：自动化脚本 / 工作流 / API 集成 / 任务管理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add m365-pnp-cli
Metadata
name
m365-pnp-cli
description
CLI for Microsoft 365 - Manage Microsoft 365 tenant, SharePoint Online, Teams, OneDrive, and more. Official PnP (Patterns and Practices) CLI.
metadata
{"openclaw":{"requires":{"bins":["m365"],"node":">=20.0.0","npmPackages":["@pnp/cli-microsoft365"]},"install":[{"id":"node","kind":"node","package":"@pnp/cli-microsoft365","label":"Install m365 CLI (npm)","description":"Install the CLI for Microsoft 365 globally: npm install -g @pnp/cli-microsoft365"}],"homepage":"https://pnp.github.io/cli-microsoft365","repository":"https://github.com/pnp/cli-microsoft365","author":"Microsoft PnP (Patterns and Practices)","keywords":["microsoft365","m365","sharepoint","teams","onenote","outlook","cli","microsoft","pnp"],"npmPackage":"@pnp/cli-microsoft365"}}

m365-pnp-cli Skill

This skill provides access to the CLI for Microsoft 365 – the official PnP (Patterns and Practices) tool for Microsoft 365 management.

⚠️ IMPORTANT FOR AGENTS

When in doubt, ALWAYS call m365 --help first to see all possibilities!

# Always call help when unsure!
m365 --help

# For specific commands:
m365 login --help
m365 spo --help
m365 teams --help

Installation

The CLI must be installed:

npm install -g @pnp/cli-microsoft365

Or use npx (sandbox):

npx @pnp/cli-microsoft365 --help

Source & Verification

What can the CLI do?

Supported Workloads

  • Microsoft Teams
  • SharePoint Online
  • OneDrive
  • Outlook
  • Microsoft To Do
  • Microsoft Planner
  • Power Automate
  • Power Apps
  • Microsoft Entra ID
  • Microsoft Purview
  • Bookings
  • And more...

Authentication

  • Device Code (default)
  • Username/Password
  • Client Certificate
  • Client Secret
  • Azure Managed Identity
  • Federated Identity

Commands (Overview)

Login/Logout

m365 login                    # Device Code Login
m365 logout                  # Logout
m365 status                  # Check login status

SharePoint Online (spo)

m365 spo site list           # List all sites
m365 spo site get --url <url>  # Get site details
m365 spo list list --webUrl <url>  # Lists in a site
m365 spo file list           # List files
m365 spo folder add          # Create folder

Teams

m365 teams channel list       # List channels
m365 teams channel get       # Get channel details
m365 teams user list         # List team members
m365 teams chat list         # List chats
m365 teams meeting list      # List meetings

OneDrive

m365 onedrive drive list    # OneDrive Drives
m365 onedrive file list     # List files
m365 onedrive file get      # Get file content

Outlook

m365 outlook mail list       # List emails
m365 outlook calendar list   # List calendar events

Planner

m365 planner task list       # Planner Tasks
m365 planner plan get        # Get plan details

Azure AD / Entra ID

m365 entra user list         # List users
m365 entra group list        # List groups
m365 entra app list          # List apps

Usage as Assistant - IMPORTANT

⚡ First Step: ALWAYS call help!

# When in doubt - call help first!
m365 --help

# For specific commands:
m365 spo --help
m365 teams --help
m365 login --help

Basic Usage

# Login (Device Code Flow)
m365 login

# Check status
m365 status

# SharePoint: List sites
m365 spo site list

# SharePoint: Get specific site
m365 spo site get --url "https://contoso.sharepoint.com/sites/test"

# Teams: List channels
m365 teams channel list --teamId <team-id>

# OneDrive: Files
m365 onedrive file list

# Outlook: Emails
m365 outlook mail list --folder Inbox

# Planner: Tasks
m365 planner task list

Output Options

# As JSON (default)
m365 spo site list

# As text
m365 spo site list --output text

# Filter with JMESPath
m365 spo site list --query "[?Template==\`GROUP#0\`].{Title:Title, Url:Url}"

Authentication

The CLI uses Device Code Flow by default:

m365 login
# → You'll receive a code on another device
# → Use that code to authenticate with Microsoft

For automated scripts, you can also use:

  • Certificate (recommended for production)
  • Client Secret (less secure)
  • Username/Password (testing only)

Important

  • WHEN IN DOUBT: call m365 --help!
  • Login required for most commands
  • JSON output is easiest to parse
  • JMESPath for efficient filtering
  • CLI requires Node.js >= 20