PowerShellを使ってMicrosoft Teamsを利用してみた

◆ Live配信スケジュール ◆
サイオステクノロジーでは、Microsoft MVPの武井による「わかりみの深いシリーズ」など、定期的なLive配信を行っています。
⇒ 詳細スケジュールはこちらから
⇒ 見逃してしまった方はYoutubeチャンネルをご覧ください
【3/22開催】テックブログを書こう!アウトプットのススメ
1年で100本ブログを出した新米エンジニアがPV数が伸びなくてもTech Blogを書き続ける理由とは?
https://tech-lab.connpass.com/event/312805/

【4/18開催】VSCode Dev Containersで楽々開発環境構築祭り〜Python/Reactなどなど〜
Visual Studio Codeの拡張機能であるDev Containersを使ってReactとかPythonとかSpring Bootとかの開発環境をラクチンで構築する方法を紹介するイベントです。
https://tech-lab.connpass.com/event/311864/

こんにちは。サイオステクノロジーの川田です。

今回はPowerShellを使って、Microsoft Teamsのグループを管理するコマンドをご紹介致します。
Microsoft TeamsとはMicrosoft社のOffice365で提供されるチャットツールになります。
詳しくは公式ページをご参照ください。

グループ作成とメンバー追加

Teamsをはじめるにあたって、グループ作成やメンバーを追加する必要があります。
※「全体管理者」か「Teamsサービス管理者」でサインインしていることが前提です。

新しいグループの作成

新しいMicrosoft365グループを作成するためには「New-UnifiedGroup」を使用します。

New-UnifiedGroup -DisplayName [表示名] -PrimarySmtpAddress [プライマリメールアドレス]
パラメーターの説明

★使用パラメーター★

  • -DisplayName:グループの名前になります。値にスペースが含まれる場合はクォーテーションで囲みます。
  • -PrimarySmtpAddress:受信者のプライマリメールアドレスを指定します。
    ※同じコマンド内でEmailAddressesパラメーターとPrimarySmtpAddressパラメーターの両方を使用することはできません。

★その他のパラメーター★

  • -AccessType:Microsoft365グループのプライバシータイプを指定します。
    Public:すべてのユーザーに利用可能
    Private:グループのメンバーのみ利用可能
    ☞管理画面で確認
    設定したグループ名をクリックし、設定情報を確認します。
    赤枠のプライバシーにAccessTypeで指定した設定が更新されます。

  • -Alias:受信者のExchangeエイリアスを指定します。
    Microsoft 365グループを作成する際に、Aliasを省略した場合はDisplayNameに指定した値が設定されます。
    ※スペースは削除され、サポートされていない文字は疑問符(?)に変換されます。

☞パラメーターの一覧はこちら

 

所有者を追加とメンバーを追加

作成したOffice365グループに所有者の追加やメンバーの追加するためには「Add-UnifiedGroupLinks」を使用します。

所有者追加

Add-UnifiedGroupLinks -Identity [設定している任意の値] -LinkType Owners -Links [所有者のメールアドレス]

メンバー追加

Add-UnifiedGroupLinks -Identity [設定している任意の値] -LinkType Members -Links [メンバーのメールアドレス]

※複数のメールアドレスを指定したい場合は、[メンバーのメールアドレス1],[メンバーのメールアドレス2]のようにカンマ区切りで記述してください。

パラメーターの説明

★使用パラメーター★

  • -Identity:変更したいMicrosoft365グループを指定します。
    任意の値とは
    〇名前
    〇エイリアス
    〇識別名
    〇電子メールアドレス等

  • -LinksType:変更するMicrosoft365グループプロパティを指定します。
    〇Member(メンバー)
    〇Owners(所有者)
    〇Subscribers(サブスクライバー)

  • -Links:Microsoft365グループに追加する受信者を指定します。
    〇名前
    〇電子メールアドレス等
    例は対象のメールアドレスを指定しています。

☞その他パラーメーターの一覧はこちら

 

グループのメンバーシップと所有権の確認

メンバーを追加した際に、追加されているか等を確認するためには「Get-UnifiedGroupLinks」を使用します。

Get-UnifiedGroupLinks -Identity [設定している任意の値] -LinkType Members

Membersを設定すると、参照したいMicrosoft365グループのメンバーを表示します。
☞パラメーターの一覧はこちら

 

グループの設定変更

一度設定したMicrosoft365グループを変更するためには「Set-UnifiedGroup」を使用します。
例は設定したグループメールアドレスを変更する書き方になります。

Set-UnifiedGroup -Identity [設定している任意の値] -PrimarySmtpAddress [変更したいメールアドレス]
パラメーターの説明

★使用パラメーター★

  • -Identity:変更するMicrosoft365グループを指定します。
  • -PrimarySmtpAddress:変更したいメールアドレスを記載します。
    ※メールアドレスが変更されると、変更前のアドレスはエイリアスに登録されます!

★その他のパラメーター★

  • -Notes:Microsoft365グループの説明を変更します。
    ※上書きされてしまうので注意!
    下記を実行すると赤い枠線の説明箇所が正常に更新されました!

    Set-UnifiedGroup -Identity "TestGroup001" -PrimarySmtpAddress [メールアドレス] -Notes "powershellから更新しました。"

  • -RequireSenderAuthenticationEnabled:内部の送信者のみがメッセージを受け入れるか指定します。
    $ture:内部からの送信者のみ受け入れる。
    $false:内部の送信者と外部の送信者から受け入れる。
    ※$falseの場合、全般設定の「外部の送信者がこのグループメールを送信することを許可する」にチェックが入ります。$trueの場合はチェックがされません。

☞その他のパラメーターの一覧はこちら

 

グルーメンバーの削除

Microsoft365グループからメンバーや所有者等を削除するには「Remove-UnifiedGroupLinks」を使用します。

Remove-UnifiedGroupLinks -Identity [設定している任意の値] -LinkType Members -Links [削除するメールアドレス] -Confirm:$false

※複数のメールアドレスを指定したい場合は、[削除メンバーのメールアドレス1],[削除メンバーのメールアドレス2]のようにカンマ区切りで記述してください。

パラメーターの説明

★使用パラメーター★

  • -Identity:変更するMicrosoft365グループを指定します。

  • -LinksType:変更するMicrosoft365グループプロパティを指定します。

  • -Confirm:実行前にコマンドの確認を表示するかしないかのパラメーターになります。
    Confirmを省略した場合は下記のようにコマンドの確認が強制されます。

    Are you sure you want to perform this action?
    Removing links from unified group [グループのメールアドレス] will remove the links permanently.
    [Y] Yes [A] Yes to All [N] No [L] No to All [?] Help (default is "Yes"): 

    確認を表示しない場合は、-Confirm:$falseと指定するとスキップされます。

☞その他のパラメーターの一覧はこちら

 

今回はMicrosoft Teamsを利用したPowerShellの一般的なコマンドをご紹介致しました。
最後までお読みいただきありがとうございました。

アバター画像
About kawada 25 Articles
Webアプリケーション開発を行っており、プログラミング初心者向けの記事や動画編集に関する内容を中心とした記事を執筆しています。
ご覧いただきありがとうございます! この投稿はお役に立ちましたか?

役に立った 役に立たなかった

0人がこの投稿は役に立ったと言っています。


ご覧いただきありがとうございます。
ブログの最新情報はSNSでも発信しております。
ぜひTwitterのフォロー&Facebookページにいいねをお願い致します!



>> 雑誌等の執筆依頼を受付しております。
   ご希望の方はお気軽にお問い合わせください!

Be the first to comment

Leave a Reply

Your email address will not be published.


*


質問はこちら 閉じる