【Microsoft365参考書】PowershellでMicrosoft365グループの情報を取得するには？Get-UnifiedGroupで取得できる情報とは？

PowershellでMicrosoft365グループの情報を取得するには？Get-UnifiedGroupで取得できる情報とは？

今回は、PowershellでMicrosoft365グループの情報を取得する場合、Get-UnifiedGroupのコマンドレットで取得することができます

Get-UnifiedGroupのコマンドレットで取得できる情報についてご紹介したいと思います。

実行するコマンドレット
出力できる情報

実行するコマンドレット

<構文>
Get-UnifiedGroup -identity <グループのメールアドレス> | Export-CSV -Encoding UTF8 -NoTypeInformation -Path "ファイルパス"

<実行例>
Get-UnifiedGroup -identity group1@contoso.com | Export-CSV -Encoding UTF8 -NoTypeInformation -Path "C:\temp\UnifiedGroup.csv"

出力できる情報

DisplayName

表示名

EmailAddresses

メールアドレス

PrimarySmtpAddress

プライマリアドレス

AccessType

公開 / 非公開の設定値

-Public : 公開
-Private: 非公開

ManagedBy

所有者ユーザー

CustomAttribute1-9

カスタム属性

ExtensionCustomAttribute1-5

拡張属性

GrantSendOnBehalfTo

代理人として送信する権限

RecipientType

オブジェクトの種類

RecipientTypeDetails

オブジェクトの種類の詳細

Language

言語設定

Notes

説明

ConnectorsEnabled

全チームのコネクタが有効/無効か確認するパラメータです。

GroupMemberCount

メンバー数

GroupExternalMemberCount

ゲストユーザー数

(外部扱いのゲストがカウントされる動作であり、リモートドメインの設定で内部扱いに設定しているドメインの場合はカウントされません)

AllowAddGuests

グループにゲストを追加することを許可(有効/無効)

ExpirationTime

グループが削除されてから復元できる期間

[復元の期限] に表示されている日付まで復元が可能であり、30 日間です。

WhenChanged

最終更新日時

WhenCreated

作成日時

RequireSenderAuthenticationEnabled

外部の送信者がこのグループへメールを送信することを許可することを指定するパラメータ
-True ：外部の送信者からのメールは許可しない
-False ：外部の送信者からのメールは許可する

ModerationEnabled

このグループに送信されるメッセージはモデレーターによる承認を要求する(有効/無効)

ModeratedBy

指定したモデレーター

SendModerationNotifications

メッセージが承認されなかった場合に送信者に通知する

-Always ：すべての送信者に通知する
-Internal ：組織内の送信者に通知する
-Never ：誰にも通知しない

SendOofMessageToOriginatorEnabled

グループメンバーの自動応答が送信者に返るように設定するパラメーター

-True : グループあてのメールは、グループのメンバーが自動応答を設定している場合は自動応答を返す
-False : グループあてのメールは、グループのメンバーが自動応答を設定している場合でも自動応答は返さない

ReportToManagerEnabledとReportToOriginatorEnabled

NDR を誰に返すか設定するパラメータ
・ ReportToManagerEnabled が False、ReportToOriginatorEnabled が True : NDR はメールの元の送信者アドレスに返ります。
・ ReportToManagerEnabled が True、ReportToOriginatorEnabled が False : NDR はグループの所有者 (一覧の一番上の一人) に返送されます。
・ ReportToManagerEnabled、および ReportToOriginatorEnabled が False : NDR はどこにも返りません。

BccBlocked

グループがBCCの場合に受信するかを指定するパラメータ
-True : グループがBccに含まれている場合は、メールの受信を拒否する
-False : グループがBccに含まれている場合でも、メールの受信を拒否しない

HiddenFromAddressListsEnable

このグループを共有アドレス帳に表示しない(有効/無効)

HiddenFromExchangeClientsEnabled

Microsoft 365 グループを Outlook on the Web および Outlook クライアントの左ペイン (メールや予定表など) から非表示とするパラメータ
True = 非表示
False = 表示

HiddenGroupMembershipEnable

グループの登録されているメンバーを非表示にするパラメータ
※グループのメンバーも含めすべてのユーザーから非表示になります。

CalendarUrl

[Outlook on the Web] の [予定表] 利用時の URL https://outlook.office.com/calendar/ にて用いられている内部プロパティ

Database

データベースを指し、内部システムにて用いられている管理用プロパティ

FileNotificationsSettings

ファイルを利用/管理する際に、内部にて自動的に用いられているプロパティ

GroupSKU

[Microsoft 365 グループ] の作成元サービスが [Temas] であるか [Yammer] であるか記録されますが、確認を目的としたプロパティではなく、内部にて用いられている管理用プロパティ
[Team] と出力された際は、Teams と連携している [Microsoft 365 グループ] を指します。
[Yammer] と出力された際は Yammer から作成された [Microsoft 365 グループ] を指します。

InboxUrl

[Outlook on the Web] の [受信トレイ] 利用時の URL https://outlook.office.com/inbox/ にて用いられている内部プロパティ

IsExternalResourcesPublished

外部への情報公開を管理している内部プロパティ

IsMailboxConfigured

メールボックス構成について内部にて用いられている管理用プロパティ

MailboxProvisioningConstraint

メールボックスのプロビジョニングについて内部にて自動的に用いられているプロパティ

ManagedByDetails

[所有者] 情報を管理している内部プロパティ

PeopleUrl

[Outlook on the Web] の [連絡先] 利用時の URL https://outlook.office.com/people/ にて用いられている内部プロパティ

PhotoUrl

写真情報を管理している内部プロパティ

SharePointDocumentsUrl

グループの SharePoint ドキュメントライブラリのURLを示しています。

SharePointNotebookUrl

グループの OneNote のURLを示しています。

IsMembershipDynamic

[メンバー] が動的であるかを示しています

GroupPersonification

[Teams] で [チーム (Microsoft 365 グループ)] 作成時、チームの種類 [クラス、PLC (プロフェッショナルラーニングコミュニティ)、スタッフ、その他] を選択した際のプロパティ

ResourceBehaviorOptions

[Microsoft 365 グループ] 作成時のみに設定される値であり、[Microsoft 365 グループ] の動作が指定された管理用の内部プロパティ

ServiceEndpointUris

[Microsoft 365 グループ] の作成元サービスが [Temas] であるか [Yammer] であるか記録されますが、確認を目的としたプロパティではなく、内部にて用いられている管理用プロパティ

InPlaceHolds

アイテム保持ポリシーや電子情報開示の保留リストの情報を管理している内部プロパティ

InPlaceHoldsRaw

Microsoft Purview アイテム保持ポリシーの個別適用が行われている場合、ポリシーの GUID が表示されます。

IsMemberAllowedToEditContent

グループのメンバーがコンテンツの編集を許可されているかを示しています。

MigrationToUnifiedGroupInProgress

[配布リスト (配布グループ)] から [Microsoft 365 グループ] にグレードアップされたかを指す内部プロパティ
[True] の際は、当初は [配布リスト (配布グループ)] で作成され、[Microsoft 365 グループ] にグレードアップされたことを表します。
[False] の際は、[Microsoft 365 グループ] にて作成されたことを表します。

PoliciesIncluded

電子メールアドレスポリシーの GUID 値が格納されている内部プロパティ

PoliciesExcluded

電子メールアドレスポリシーの GUID 値が格納されている内部プロパティ

CalendarMemberReadOnly

予定表の編集を制限するパラメータ

SubscriptionEnabled

グループの所有者が、所有するグループの会話と予定表イベントのサブスクリプションを有効にできるかどうかを指定します。
[$true] で設定したい場合には、値を指定せずにこのスイッチを使用します。
なお、False に設定する場合には [AutoSubscribeNewMembers] も併せて False に設定する必要があります。

AlwaysSubscribeMembersToCalendarEvents

Microsoft 365 グループに追加された新しいメンバーの既定のサブスクリプション設定を制御します。
[$true] で設定したい場合には、値を指定せずにこのスイッチを使用します。
[$true] で設定した場合、グループに今後追加されるすべてのメンバーについて、サブスクリプションが [自分への返信とグループのイベントだけを受信する] に設定されます。
すでにチームに設定されている予定やイベントは、個人の予定表に自動的に追加されません。
[$false] に設定すると、グループに今後追加されるすべてのメンバーについて、サブスクリプションが [自分への返信だけを受信する] に設定されます。

AutoSubscribeNewMembers

Microsoft 365 グループに追加される新しいメンバーを会話や予定表イベントに自動的に登録させるかどうかを設定するパラメータ
[$true] の場合、新規で追加されたグループメンバーに、既存の会議予定やアイテムを表示させる設定となります。
[$false] の場合、新規で追加されたグループメンバーに、既存の会議予定やアイテムを表示させず、新規で追加されたアイテムのみ表示させる動作となります。