Get-UnifiedGroup
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Get-UnifiedGroup コマンドレットを使用して、クラウドベースのorganizationのMicrosoft 365 グループを表示します。 Microsoft 365 グループのメンバー、所有者、サブスクライバーを表示するには、Get-UnifiedGroupLinks コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Identity (既定)
Get-UnifiedGroup
[[-Identity] <UnifiedGroupIdParameter>]
[-Filter <String>]
[-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
[-IncludeAllProperties]
[-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
[-IncludeGrantSendOnBehalfToWithDisplayNames]
[-IncludeModeratedByWithDisplayNames]
[-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
[-IncludeSoftDeletedGroups]
[-ResultSize <Unlimited>]
[-SortBy <String>]
[<CommonParameters>]
AnrSet
Get-UnifiedGroup
[-Anr <String>]
[-Filter <String>]
[-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
[-IncludeAllProperties]
[-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
[-IncludeGrantSendOnBehalfToWithDisplayNames]
[-IncludeModeratedByWithDisplayNames]
[-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
[-IncludeSoftDeletedGroups]
[-ResultSize <Unlimited>]
[-SortBy <String>]
[<CommonParameters>]
説明
Microsoft 365 グループは、Microsoft 365 サービス全体で利用可能なグループ オブジェクトです。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-UnifiedGroup
この例では、すべてのMicrosoft 365 グループの概要リストを返します。
例 2
Get-UnifiedGroup | Format-List DisplayName,EmailAddresses,Notes,ManagedBy,AccessType
この例では、すべてのMicrosoft 365 グループに関する次の情報を返します。
- 表示名
- 電子メール アドレス
- 説明
- 所有者
- プライバシー
例 3
Get-UnifiedGroup -Identity "Marketing Department" | Format-List
この例では、マーケティング部門という名前の Microsoft 365 グループに関する詳細情報を返します。
例 4
Get-UnifiedGroup | Where-Object {-Not $_.ManagedBy}
次の使用例は、所有者がいないMicrosoft 365 グループを返します。
例 5
Get-UnifiedGroup -Filter {ResourceProvisioningOptions -eq "Team"}
次の使用例は、Microsoft Team の作成時に作成されたMicrosoft 365 グループを返します。
パラメーター
-Anr
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AnrSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Filter
適用対象: Exchange Online、Exchange Online Protection
Filter パラメーターは、OPATH 構文を使用して、指定したプロパティと値で結果をフィルター処理します。 検索条件は構文"Property -ComparisonOperator 'Value'"を使用します。
- OPATH フィルター全体を二重引用符 " " で囲みます。 フィルターにシステム値 (例えば、
$true、$false、または$null) が含まれている場合は、代わりに単一引用符 ' ' を使用します。 このパラメーターは文字列 (システム ブロックではありません) ですが、波かっこ { } を使用することもできますが、これはフィルターに変数が含まれていない場合のみです。 - Property はフィルタリング可能なプロパティです。 Exchange サーバーとExchange Onlineのフィルター可能なプロパティの詳細については、「Filter パラメーターのフィルター可能なプロパティ」を参照してください。
- ComparisonOperator は OPATH 比較演算子です (たとえば、文字列比較の場合は等号と
-likeの-eq)。 比較演算子の詳細については、「about_Comparison_Operators」を参照してください。 - Value は、検索するプロパティ値です。 テキスト値と変数を一重引用符 (
'Value'または'$Variable') で囲みます。 変数値に一重引用符が含まれている場合、変数を正しく展開するには、一重引用符を識別する (エスケープする) 必要があります。 たとえば、'$User'の代わりに'$($User -Replace "'","''")'を使用します。 整数またはシステム値を引用符で囲まないでください (たとえば、代わりに500、$true、$false、または$nullを使用します)。
論理演算子 -and および -or を使用すると、複数の検索条件を連結することができます。 たとえば、"Criteria1 -and Criteria2" または "(Criteria1 -and Criteria2) -or Criteria3" です。
Exchange の OPATH フィルターの詳細については、「 その他の OPATH 構文情報」を参照してください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Online、Exchange Online Protection
Identity パラメーターは、表示する Microsoft 365 グループを指定します。 Microsoft 365 グループを一意に識別する任意の値を使用できます。 例:
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- 電子メール アドレス
- GUID
注: DisplayName 値を使用して Microsoft 365 グループを識別できますが、結果が一意であるとは限りません。 単一の一意の結果を返す必要がある場合は、Microsoft 365 グループの一意の識別子を使用します。
パラメーターのプロパティ
| 型: | UnifiedGroupIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames
適用対象: Exchange Online、Exchange Online Protection
IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames スイッチは、AcceptMessagesOnlyFromSendersOrMembers 受信者の SMTP アドレスと表示名を AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames プロパティで返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチは、コマンドレットの結果で人間が判読できる識別子を復元するために導入されました。 このスイッチを使用しない場合、AcceptMessagesOnlyFromSendersOrMembers 受信者は GUID として表示され、AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames プロパティは空です。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeAllProperties
適用対象: Exchange Online、Exchange Online Protection
IncludeAllProperties スイッチは、すべてのプロパティの値を結果に含めるかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用しないと、一部のプロパティ (CalendarMemberReadOnly、CalendarUrl、InboxUrl、PeopleUrl、PhotoUrl など) の値が空白で表示される場合があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeBypassModerationFromSendersOrMembersWithDisplayNames
適用対象: Exchange Online、Exchange Online Protection
IncludeBypassModerationFromSendersOrMembersWithDisplayNames スイッチは、BypassModerationFromSendersOrMembers プロパティの BypassModerationFromSendersOrMembers 受信者の SMTP アドレスと表示名を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチは、コマンドレットの結果で人間が判読できる識別子を復元するために導入されました。 このスイッチを使用しない場合、BypassModerationFromSendersOrMembers 受信者は GUID として表示され、BypassModerationFromSendersOrMembersWithDisplayNames プロパティは空です。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeGrantSendOnBehalfToWithDisplayNames
適用対象: Exchange Online、Exchange Online Protection
IncludeGrantSendOnBehalfToWithDisplayNames スイッチは、GrantSendOnBehalfToWithDisplayNames プロパティの GrantSendOnBehalfTo 受信者の SMTP アドレスと表示名を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチは、コマンドレットの結果で人間が判読できる識別子を復元するために導入されました。 このスイッチを使用しない場合、GrantSendOnBehalfTo 受信者は GUID として表示され、GrantSendOnBehalfToWithDisplayNames プロパティは空です。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeModeratedByWithDisplayNames
適用対象: Exchange Online、Exchange Online Protection
IncludeModeratedByWithDisplayNames スイッチは、ModeratedByWithDisplayNames プロパティの ModeratedBy 受信者の SMTP アドレスと表示名を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチは、コマンドレットの結果で人間が判読できる識別子を復元するために導入されました。 このスイッチを使用しない場合、ModeratedBy 受信者は GUID として表示され、ModeratedByWithDisplayNames プロパティは空です。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames
適用対象: Exchange Online、Exchange Online Protection
IncludeRejectMessagesFromSendersOrMembersWithDisplayNames スイッチは、RejectMessagesFromSendersOrMembers プロパティの RejectMessagesFromSendersOrMembers 受信者の SMTP アドレスと表示名を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチは、コマンドレットの結果で人間が判読できる識別子を復元するために導入されました。 このスイッチを使用しない場合、ModeratedBy 受信者は GUID として表示され、RejectMessagesFromSendersOrMembersWithDisplayNames プロパティは空です。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeSoftDeletedGroups
適用対象: Exchange Online、Exchange Online Protection
IncludeSoftDeletedGroups スイッチは、論理的に削除されたMicrosoft 365 グループを結果に含めるかどうかを指定します。 このスイッチで値を指定する必要はありません。
論理的に削除されたMicrosoft 365 グループは、まだ回復可能な削除されたグループです。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResultSize
適用対象: Exchange Online、Exchange Online Protection
ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SortBy
適用対象: Exchange Online、Exchange Online Protection
SortBy パラメーターは、結果を並べ替えるためのプロパティを指定します。 並べ替えの基準にできるのは、一度に 1 つのプロパティのみです。 結果は昇順で並べ替えられます。
既定のビューに並べ替えの対象のプロパティが含まれていない場合は、コマンドを | Format-Table -Auto Property1,Property2,...PropertyXで追加できます。 をクリックして、表示するすべてのプロパティを含む新しいビューを作成します。 プロパティ名にはワイルドカード (*) がサポートされています。
以下のプロパティで並べ替えることができます。
- 名前
- DisplayName
- Alias
パラメーターのプロパティ
| 型: | String |
| 規定値: | 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」を参照してください。