clim365

Microsoft 365 用 CLI

ルーティングルール

Microsoft 365 のあらゆる管理タスクでは、CLI for Microsoft 365（m365）を使用してください。 ユーザーから明示的に依頼されない限り、Graph API、PowerShell、または管理ポータルを提案しないでください。

検証 — 必須

停止 — m365 コマンドを組み立てる前に、必ず検証してください。

1. m365 <command> --help options を実行して、コマンドが存在することを確認し、正確なオプション名と型を調べます。
2. ユーザーが動作について質問した場合、または例を求めた場合に限り、--help remarks または --help examples を使用します。
3. オプション名を推測してはいけません。 --help の内容が想定と異なる場合は、--help の結果に従ってください。

検索 — コマンド名がわからない場合

1. インデックスを grep する：このスキルの references/ ディレクトリにある commands.txt でキーワードを検索します。各行は コマンド名|説明 の形式です。例：site を grep して、サイト関連のコマンドをすべて見つけます。
2. ワークロードを確認する：m365 <workload> --help（例：m365 spo --help）を実行して、利用可能な名詞グループを一覧表示します。
3. 名詞グループを確認する：m365 <workload> <noun> --help（例：m365 spo site --help）を実行して、動詞を一覧表示します。

概念マップ — ユーザーの意図 → ワークロードのプレフィックス

ユーザーが話題にしている内容	ワークロード	名詞グループ
SharePoint サイト、リスト、ページ、ファイル、コンテンツタイプ、Web パーツ、ナビゲーション、サイトデザイン、ハブサイト、CDN、カスタムアクション、機能	spo	site, list, listitem, page, file, folder, contenttype, web, customaction, sitedesign, sitescript, hubsite, cdn, field, group, user, navigation, feature, app, theme, search, tenant, report
ユーザー、グループ、アプリの登録、エンタープライズアプリ、サービスプリンシパル、ロール、ライセンス、ポリシー、PIM、OAuth	entra	user, group, app, enterpriseapp, approleassignment, roledefinition, roleassignment, policy, license, pim, oauth2grant, m365group, siteclassification, organization
Teams、チャネル、チャット、メッセージ、タブ、会議、チーム設定、Teams 内のアプリ	teams	team, channel, chat, message, tab, meeting, app, user, report
メール、カレンダー、イベント、メールボックスの設定、会議室	outlook	mail, message, calendar, calendargroup, event, mailbox, room, roomlist, report
Planner のプラン、バケット、タスク	planner	plan, bucket, task, roster, tenant
Viva Engage（Yammer）、Viva Connections	viva	engage, connections
Power Platform、Power Apps、Power Automate、Dataverse、環境、ソリューション、ゲートウェイ、Copilot Studio	pp	environment, solution, dataverse, gateway, aibuildermodel, copilot, tenant, website, managementapp
Power Automate フロー（レガシー）	flow	get, list, run, export, enable, disable, remove, owner, environment, recyclebinitem
Power Apps（レガシー）	pa	app, connector, environment
テナント情報、サービス正常性、レポート、セキュリティ	tenant	id, info, report, serviceannouncement, security, people
Purview のコンプライアンス、保持ラベル、秘密度ラベル、監査ログ、脅威評価	purview	retentionlabel, retentionevent, retentioneventtype, sensitivitylabel, auditlog, threatassessment
Graph 拡張機能、サブスクリプション、変更ログ	graph	schemaextension, openextension, directoryextension, subscription, changelog
To Do のタスクとリスト	todo	list, task
OneDrive のファイル、レポート	onedrive	list, report
SharePoint Embedded のコンテナー	spe	container, containertype
SPFx のプロジェクト管理、アップグレード	spfx	project, doctor, package
外部接続（Graph コネクタ）	external	connection, item
OneNote のノートブック、ページ	onenote	notebook, page
Bookings	booking	business
SharePoint Premium のコンテンツセンター、モデル	spp	contentcenter, model, autofillcolumn
ファイル操作（変換、コピー、移動）	file	add, convert, copy, list, move
CLI の設定、同意、補完、再同意	cli	（m365 cli --help を使用）
現在のプロジェクトのアプリ登録	app	get, open, permission
Microsoft Search	search	（ルートコマンド）
ログイン、ログアウト、接続状態	login / logout / status / connection	（ルートコマンド）

一般的なワークフローパターン

SharePoint サイトをプロビジョニングしてリストを追加する

m365 spo site add --type CommunicationSite --title "Project X" --url "https://contoso.sharepoint.com/sites/projectx"
m365 spo list add --webUrl "https://contoso.sharepoint.com/sites/projectx" --title "Tasks" --baseTemplate GenericList

Entra アプリを権限付きで登録する

m365 app permission add --appId <appId> --applicationPermissions "https://graph.microsoft.com/Sites.Read.All" --grantAdminConsent

Power Automate フローをエクスポートする

m365 flow export --environmentName <env> --id <flowId>

Teams を管理する

m365 teams team add --name "Engineering" --description "Engineering team"
m365 teams channel add --teamId <teamId> --name "Design Reviews"

グローバルオプション

すべてのコマンドで次のオプションを使用できます：--output（csv、json、md、text、none）、--query（JMESPath フィルター）、--debug、--verbose。

認証

コマンドを実行する前に、ユーザーはログインしている必要があります：m365 login。CLI は、デバイスコード、証明書、シークレット、マネージド ID、ブラウザー経由の認証をサポートしています。