Get-UnifiedGroupLinks
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Get-UnifiedGroupLinks コマンドレットを使用して、クラウドベースの組織のMicrosoft 365 グループのメンバーシップと所有権の情報を表示します。 Microsoft 365 グループの他のプロパティを表示するには、Get-UnifiedGroup コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Get-UnifiedGroupLinks
[-Identity] <UnifiedGroupIdParameter>
-LinkType <LinkType>
[-ResultSize <Unlimited>]
[<CommonParameters>]
説明
Microsoft 365 グループは、Microsoft 365 サービス間で使用できるグループ オブジェクトです。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-UnifiedGroupLinks -Identity "Human Resources Department" -LinkType Members
この例では、人事部という名前のMicrosoft 365 グループのメンバーを示します
パラメーター
-Identity
Identity パラメーターは、表示するMicrosoft 365 グループを指定します。 Microsoft 365 グループを一意に識別する任意の値を使用できます。 例:
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- 電子メール アドレス
- GUID
Type: | UnifiedGroupIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-LinkType
LinkType パラメーターは、Microsoft 365 グループの受信者ロールによって結果をフィルター処理します。 有効な値は次のとおりです。
- メンバー: 会話に参加し、Teams チャネルを作成し、ファイルで共同作業を行い、接続された SharePoint サイトを編集します。
- 所有者: メンバーの追加または削除、会話の削除、チーム設定の変更、チームの削除、接続された SharePoint サイトのフル コントロール。 グループには、最低 1 人の所有者が必要です。
- サブスクライバー: グループから会話と予定表のイベント通知を受け取るメンバー。 すべてのサブスクライバーはグループのメンバーですが、すべてのメンバーが必ずしもサブスクライバーであるとは限りません (グループの AutoSubscribeNewMembers プロパティの値とメンバーが追加されたタイミングに応じて異なります)。
Type: | LinkType |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-ResultSize
ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |