カテゴリ「Microsoft 365 - SharePoint」の342件の投稿 Feed

2023年1月27日 (金)

SharePoint を利用する際、画像や JavaScript、スタイルシートなどの静的資産データに関しては Office 365が備えているコンテンツ配信ネットワーク (CDN) でホストできるようになっています。この CDN を Office 365 CDN と言います。CDN を利用することでダウンロードが早くなり待ち時間が短縮されるようになっています。

Office 365 CDN は SharePoint Online のサブスクリプションに含まれています。

とはいえ、Office 365 CDN の利用には事前設定が必要であり、SharePoint を使い始めている組織でもこの存在をよく知らずに使っていることも少なくないようです。CDN を使うことによる問題がなければ、少しでも高速に使えるようになるので CDN はできるかぎり構成するようにしましょう。

CDN の種類

CDN にはパブリック CDN プライベートCDN の2種類があります。

---------------------------------------------------

パブリックCDN:

JS (JavaScript)、CSS (スタイルシート)、Web フォント ファイル (WOFF、WOFF2)、および会社のロゴなどの非独自のイメージに使用するように設計されています。

プライベートCDN:

画像 (PNG、JPG、JPEG など) に使用するように設計されています。

---------------------------------------------------

パブリック CDN もプライベート CDN もテナントの管理者が有効化しないと利用できないものだったのですが、2023年1月23日にプライベート CDN の構成が不要になるというアナウンスがされました。

20230127_161926

この変更は 2023年3月上旬からロールアウトが開始され同月下旬には完了を予定しているとのこと。そのため、プライベートCDNは意識しなくても自動管理されるようになるわけです。

ですが、相変わらずパブリックCDNは明示的に指定しないと利用できないため注意してください。

CDNが有効なのか確認したい

サイトの所有者またはサイトの管理者の方は、自分が使っている環境でCDNが有効化どうかを確認するには SharePoint 診断ツールを使いましょう。Edge または Chrome の拡張機能として、このツールをインストールできます。ツールの使い方は下記に公開されています。

SharePoint Online のページ診断ツールを使用する - Microsoft 365 Enterprise | Microsoft Learn

※私の執筆した「ひと目でわかる Microsoft 365 SharePoint 運用管理編」の P533 ~でもパフォーマンス診断方法として触れています。CDN に関してはあまり言及できていませんでしたけど。

このツールを実行すると、パブリックCDNが有効でない場合は次のように表示されます。

20230127_160041

ちなみに、ツールをインストールしたら SharePoint サイトにアクセスしているブラウザーを閉じるかタブを閉じて再度アクセスしないと診断ツールを起動するときに「これはSharePoint ページではない」とのメッセージがでてきます。

📗参考情報

Office 365 CDN に関する詳細情報は下記のリンクを参照してください。

2023年1月26日 (木)

以前の投稿でStream (on SharePoint) に移行ツールを使えば、Stream (クラシック)への既存のリンクはしばらくの間はリダイレクトされるという話を書きました。

🔗 SharePoint Technical Notes : Stream (on SharePoint)への移行: リダイレクトについて (lekumo.biz)

特に SharePoint ページに Stream Webパーツを使ってビデオコンテンツを配置しているケースが多いと思います。そんな中、Microsoft MVP の一人である てっちゃん (@techan_k) さんが SharePoint ページ上にある Stream Webパーツを CSV ファイルに書き出すスクリプトを公開してくれています。助かりますね。

📝 Export of Stream (Classic) Web Parts and pages that use them | PnP Samples

20230126_103356

私の方でもさっそく試してみたのですが、メモ書きを残しておこうと思います。

PnP PowerShellを使う準備

PnP PowerShell を使うため事前準備が必要です。PnP の概要などは下記にまとめています。

🔗 SharePoint Technical Notes : PnP PowerShell の概要とインストール (lekumo.biz)

実行

まずはローカルにスクリプトファイル(*.ps1)を用意します。例では "spo-export-stream-classic-webparts.ps1"というファイル名が使われているので、これにしておくとよいでしょう。ここに、GitHubに公開されているスクリプトをコピーして貼り付けておきます。

スクリプトの実行方法は上記のGitHub内およびスクリプト内のコメントにも書かれていますので確認しておきましょう。

20230125_121706

都度、サイトを指定してサイト単位で Stream Webパーツがあるページを探索することになります。

20230124_223853_2

結果はCSVファイルに出力されます。出力場所はマイドキュメント(My Documents)内に作成される "StreamClassicWebPartsReport" フォルダーです。

スクリプト実行後に、このフォルダーを開くようにしたい場合は、次のように -openFolder オプションを指定してスクリプトを実行します。

.\spo-export-stream-classic-webparts.ps1 -siteUrl "https://contoso.sharepoint.com/PnPScriptSamples" -openFolder 

実行すると「日付-サイト名.csv」という名前付け規則でCSVファイルが生成されます。ちなみにスクリーンショットでは訳があって「日付-サイトID」で生成しています。20230124_223952

このファイルを確認すれば、どのページに当該Webパーツが埋め込まれているかがわかります。

20230125_122134

注意点

最終的にはスクリプトの実行は首尾よくいったのですが、最初はいくつかのエラーに遭遇したので備忘録して残しておきます。

最初のエラーは Getting SitePages .. Started 時点で遭遇したページのエラーでした。このページを実際に開くと前に何かを試したのかページ自体がエラーとなっていました。おそらくWebパーツの不具合だったと思いますが、よくみると作りかけで実際には参照していないものであったためページ自体を削除しました。

次が Processing pages -- Started 時点のエラーで、下記が実際のエラー画面です。「フォルダーに...」というページ。

20230124_222924

なんだろうとページを開いたのですが、こちらはページ自体何も問題ない。ですが、ページの詳細を確認すると説明部分に文字化けが。。。本文に書いていた絵文字までが説明部分に追加されており、文字化けしていたわけです。Cannot read incomplete UTF-16 JSON text とエラーメッセージにあるので、これかなと詳細ウィンドウを修正し文字化けを取り除きました。20230125_091406

さて、ここまででページの取得は無事に完了したのですが、CSVファイルの出力でまたエラー。なんだろうとよくよく確認すると、運悪く対象のサイト名が「SharePoint/OneDrive/Stream の利活用」となっている。サイト名にファイル名に使用できない文字が含まれていたのです。手っ取り早く修正するためにスクリプトを修正して $site.Title を $site.ID に置き換えました。


20230124_222823

以上で無事にスクリプトが実行できたわけです。

最後に

最後に遭遇した不具合の情報を書きましたが、スクリプト自体は自分で作ると面倒ですし、そもそもPowerShellを書くための基礎知識が必要です。こうしたスクリプトを公開し共有してくれるのは、本当に助かります。

これで新しい Stream への移行が少しでもスムーズにいくといいですね。

SharePoint サイトのコンテンツを一括管理したい場合などに便利なのが PnP PowerShell です。オープンソースのコミュニティが提供しています。

本記事では PnP PowerShell の概要とインストール方法に関するリファレンスをまとめておきます。

概要

もともとSharePoint PnP (Patterns & Practices : パターンズ アンド プラクティス) イニシアティブというものがあり、Microsoft 社のコンサルタントのメンバーが 2013 年に設立したのが始まりでオープンソースの技術コミュニティです。Microsoft 社以外からも Microsoft MVP などの有志が積極的にメンバーとして貢献していますし、誰でも Contributerとして立候補もできます。

なお、このコミュニティはのちに SharePoint Developer Community という名称となり、現在は SharePoint だけでなくMicrosoft 365 全般にわたり活動しているため Microsoft 365 Platform Comunity (PnP) という名称になっています。

コミュニティでは GitHub 上で様々なガイダンス、コードサンプルや便利なツールなどを公開しています。

SharePoint PnP PowerShell 

Microsoft 365 のSharePoint の管理者が利用する SharePoint Online Management Shell も PowerShell コマンドレットを提供していますが、こちらは SharePoint テナントレベルでの管理者権限が必要であり、また SharePoint 管理センターレベルの設定を行うためのコマンド群です。サイトコレクションの管理、サイトデザインやサイトスクリプトの登録、SharePoint ハブの登録や解除などがありますが、サイトごとのコンテンツ管理までは行えません。

一方でSharePoint PnP PowerShell はもともと SharePoint Client Side API を用いたコマンドレットであり、サイトの管理者がコンテンツ管理を行えるようになっています。

👑PnP PowerShell (推奨)

従来は SharePoint に特化していた SharePoint PnP PowerShell ですが改善を続けています。現在は SharePoint 以外にも Microsoft Teams, Microsoft Planner, Power Automate などでも利用できるようになっており、名称も「SharePoint」を冠から外し単に「PnP PowerShell」と呼ぶようになっています。

PnP PowerShell はクロスプラットフォームの PowerShell モジュールとなっており、非常に多くのコマンドレッドが用意されています。この新しいモジュールは SharePointPnPPowerShellOnlineモジュールの後継となっており、従来のモジュールはすでにメンテナンスされなくなっています。新しいモジュールはクロスプラットフォーム対応となっているため Windows だけでなく、MacOSや Linux 上でも実行できます。ただし、クロスプラットフォームとして利用する場合は対象は SharePoint だけがサポートされます。

詳しくは下記のサイトを参照してください。

🔗 PnP PowerShell | PnP PowerShell

インストール方法

さて、インストールですが PowerShell 7.x を使用することが推奨されています。実際、PowerShell 5.x を使っていたとしても一部のコマンドは利用できますが、経験上エラーとなることもしばしばあるため PowerShell 7.x をインストールするようにしましょう。

インストール手順は下記の情報を参照してください。

🔗 Windows への PowerShell のインストール - PowerShell | Microsoft Learn

インストール自体は基本的には次のコマンドで行えます。

Install-Module -Name PnP.PowerShell

ただし、認証に関する設定も必要になるため注意が必要です。PnP PowerShellでは、テナントへの認証情報を使って認証することができます。ただし、基盤となる SDK の変更により、認証が可能な Azure AD アプリケーションを最初に登録する必要があります。

複数の方法が用意されており、組織によって適切な手順がことなります。詳しくは下記のページで確認してください。ちなみに、一番簡単なのは「Register-PnPManagementShellAccess」コマンドを実行することです。これで済むのが一番。。。

🔗 Authentication | PnP PowerShell

PnP PowerShellの最新版は PowerShell Gallery で確認できます。

🔗 https://www.powershellgallery.com/packages/PnP.PowerShell/

2023年1月13日 (金)

移行の話の続きです。

SharePoint ページなどにStream (クラシック) 上のビデオへのリンクを追加しているケースも多いと思います。

移行ツールによる移行後は、しばらくの間、旧リンクにアクセスすると新しいコンテンツの場所へとリダイレクトしてくれます。ただし、このリダイレクトも Microsoft Stream (クラシック) 廃止後から1年間のみで期限は 2025年2月15日までです。それまでに修正しておかないとリンク切れが多発することなります。

SharePoint ページでは Stream 用のWebパーツが用意されていましたが、Stream (on SharePoint) のコンテンツを埋め込む場合は、ファイルビューアーWebパーツを用います。当該ユーザーにリンクの差し替えを依頼するなどの対応も考えておく必要があります。

移行ツールは SharePoint管理者または Stream 管理者しか利用できません。

そのため必要に応じて各ビデオの所有者に依頼して自分で必要なものは手動でダウンロードし、適切な SharePoint サイトまたは OneDrive for Business 上に再度アップロードしてもらい、Webパーツの再設定なども依頼しておくとよいでしょう。

ユーザーには手間を書けますが、移行ツールで一括すると案外不要なコンテンツもそのまま持っていくことになることもあります。大量のデータの場合はやはりツールを使うべきですが、対応するユーザーが担当するコンテンツの量がさほど多くないようであれば、手間がかかる分、取捨選択もすることになると思います。ついでの整理整頓の機会にもなるように思います。ビデオが古くなっていたら、この際、新規に作り直そうか、というきっかけづくりにもなるかもしれません。

なお、移行ツールで移行したコンテンツをさらに手動で別の場所に移動させてしまうと、さすがにそこまでは追いかけてはくれないため、やはりリダイレクトはできなくなります。こうした点も注意しましょう。

※補足: このページのタイトルを「Microsoft Stream (on SharePoint)への移行スケジュールを把握しよう!」から「Microsoft Stream (クラシック) の廃止日決定 ⇒ 2024年2月15日」に変更しました。

※補足: 当初はクラシック Stream の完全廃止日は、2024/2/15が期限だったが、その後、期限が延期され 2024/4/15 に変更されました。

昨年、Microsoft Stream (on SharePoint) の移行スケジュールについてブログを公開しました。

SharePoint Technical Notes : Microsoft Stream (on SharePoint)への移行スケジュールを把握しよう! (lekumo.biz)

年明けが明けて、昨日の2023/1/12 付で Microsoft 365 のメッセージセンターにいよいよ Stream (クラシック) の廃止日がアナウンスされました。

20230113_103539

主なマイルストーンは次の通りです。

  • 廃止日: 2024/2/15 ⇒ 2024/4/15 に延期
  • Stream (クラシック) への新規アップロードの停止日:  2023/9/15
  • Stream (クラシック) へアクセスできなくなる日: 2023/10/15 (延長措置をしていれば、2024/4/15 が期限)

公式情報は下記を確認してください。

Overview of migrating from Microsoft Stream (Classic) to Stream (on SharePoint) - Microsoft Stream | Microsoft Learn

※今後の予定の部分のみ画面を抜粋して追加しておきます。

20230113_104445

以前のブログにも書きましたが、移行ツールが GA された日付から 1年後にサービス廃止となる予定です。現時点では移行ツールはパブリックプレビューです。廃止日がアナウンスされたので、ここから逆算すると移行ツールの GA 日は2023/2/15 → 2023/4/15  (に延期) となるということでしょう。

B5f84c0cd7944aa8aef481fab1a2bd7d_2

ただ、予定を確認していると移行するビデオのフィルターリング機能が利用できるようになるのが 2023/6/1 となるようで、GA後も機能アップデートがされるようです。

また、上記のマイルストーンは、前回のブログにも書きましたが、あくまでも延長を行わない場合のものです。

Cc2366bcd74e4d77bfbaa0e77c5706fd

最終廃止日は変わりませんが、それ以外に関しては数か月延長できます。

Stream (クラシック) への新規アップロードの停止日」に関しては廃止日の通知日 + 3か月後となるため3か月後の 2023/5/15 が期限となっていますが、3か月延長できるため延期措置を取れば 2023/8/15 が期限です。また、「Stream (クラシック) へアクセスできなくなる日」については、廃止通知の8か月後が期限であるため 2023/10/15 が期限ですが4か月延長ができます。延長措置を取れば 2024/2/15 までが期限となり廃止日いっぱいまで利用できるようになるわけです。

詳細は公式ドキュメントを確認しておきましょう。

Stream (on SharePoint) のメリット

Stream (on SharePoint) への移行を行うことで、色々と利点が生まれます。個人的には次の点が大きいのです。

  • 社外との動画共有
  • 動画の日本語検索 (トランスクリプト検索)

現在の Stream は前身は Office 365 Videos でした。これは SharePoint をベースに作られた仕組みでしたが、社外共有ができない課題を長年持っていました。そこから Stream が登場し独自の Azure ベースのストレージを持つようになり、社外共有もできるようになるのか? と思われましたが、結局できないままとなり検索などが案外と多言語対応できなかったのです。ですが、AI を組み合わせるという仕組みが画期的でした。

そうした過去のトライアンドエラーを経て、再び SharePoint ベースの動画共有の仕組みに戻ってきたのが Stream (on SharePoint ) です。SharePoint も過去と比較すると格段に機能が豊富になり、改善・改良がくわえられてきました。そんななか今度は再び SharePoint に戻ってきたといっても、満を持して戻ってくることとなり、過去に対応できなかった様々な機能が利用できるようになります。

下記はメッセージセンターに配信された内容の日本語訳です。

  • SharePoint や OneDrive にある他のファイルと同様に、セキュリティ、管理者コントロール、マルチジオサポート、コンプライアンス(eDiscovery、法的拘束、保持、データ損失防止ポリシー)、権限、共有コントロールでビデオファイルを容易に管理できます。
  • 背景のぼかしや置き換え、インク付け、テキスト、音声のみ、テレプロンプターなど、カメラに直接搭載された高度なツールを使ってビデオを録画。
  • Microsoft 365 のどこからでもビデオを検索できます。キーワードを検索することで、Microsoft 365のあらゆる場所でビデオやTeamsの会議記録を見つけることができるようになりました。
  • Office の Stream スタートページで、必要なものをすばやく見つけられます。新しいスタートページには、最近見たビデオ、共有されているビデオ、お気に入りのビデオが表示され、プレイリストも近日公開予定です。(注: Streamのスタートページでは、Stream (Classic)のビデオは表示されません)。
  • チームミーティングの記録を、トランスクリプト、チャプター、タイムラインマーカー、発言者の属性、コメントとともに表示できます。
  • カスタムページ、サイト、ポータルを作成し、イントラネットやViva Connectionsの一部としてビデオをフィーチャーすることができます。
  • ゲスト、組織内の人、「誰でも」リンクによる認証なしの外部共有をサポートし、Microsoft 365 の他のファイルと同じように動画を共有できます。
  • 動画ごとの解析、サイト内のすべての動画の解析、動画を視聴した人の解析が可能です。
    Viva Connectionsフィードにビデオを追加します。
  • Microsoft Graph Files API をベースとした API を使用して、基本的な動画ファイルの操作を行います。

移行作業は少々面倒ではありますが、ようはうちの引っ越しと同じです。この際、使わなくなったビデオを捨て、よりよい使い勝手を得られるということで組織で計画的に取り組んでいきたいですね。