Get-UnifiedGroupLinks

モジュール:
Exchange PowerShell

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

Get-UnifiedGroupLinks コマンドレットを使用して、クラウドベースのorganizationで Microsoft 365 グループ のメンバーシップと所有権の情報を表示します。 Microsoft 365 グループ の他のプロパティを表示するには、Get-UnifiedGroup コマンドレットを使用します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Default (既定) 

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

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

ID パラメーターは、表示する Microsoft 365 グループを指定します。 Microsoft 365 グループを一意に識別する任意の値を使用できます。 例:

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • 電子メール アドレス
  • GUID

注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。

パラメーターのプロパティ

型:UnifiedGroupIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-LinkType

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

LinkType パラメーターは、Microsoft 365 グループの受信者の役割で結果をフィルター処理します。 有効な値は次のとおりです。

  • メンバー: 会話への参加、Teams チャネルの作成、ファイルでの共同作業、接続された SharePoint サイトの編集を行います。
  • 所有者: メンバーの追加または削除、会話の削除、チーム設定の変更、チームの削除、接続されている SharePoint サイトのフル コントロール。 グループには、最低 1 人の所有者が必要です。
  • サブスクライバー: グループから会話や予定表イベントの通知を受け取るメンバー。 すべてのサブスクライバーはグループのメンバーですが、すべてのメンバーが必ずしもサブスクライバーであるとは限りません (グループの AutoSubscribeNewMembers プロパティの値とメンバーが追加されたタイミングによって異なります)。

パラメーターのプロパティ

型:LinkType
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResultSize

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。

パラメーターのプロパティ

型:Unlimited
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。