こんにちは。サイオステクノロジーの川田です。
今回は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の一般的なコマンドをご紹介致しました。
最後までお読みいただきありがとうございました。