次の方法で共有

Get-AzureADMSGroup

  • リファレンス
モジュール:
AzureAD

Microsoft Entra ID のグループに関する情報を取得します (MS Graph 経由)。

構文

Get-AzureADMSGroup
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADMSGroup
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADMSGroup
   -Id <String>
   [-All <Boolean>]
   [<CommonParameters>]

説明

Get-AzureADMSGroup コマンドレットは、Microsoft Graph を使用して Microsoft Entra ID 内のグループに関する情報を取得します。 グループを取得するには、Id パラメーターを指定します。 特定のグループを検索するには、SearchString または Filter パラメーターを指定します。 パラメーターを指定しない場合、このコマンドレットはすべてのグループを取得します。

例

例 1: すべてのグループを取得する

PS C:\> Get-AzureADMSGroup

Id                            : d539a25e-2db2-482a-9dcb-2a0b27fe4f27
Description                   :
OnPremisesSyncEnabled         :
DisplayName                   :
ADSyncOperators
OnPremisesLastSyncDateTime    :
Mail                          :
MailEnabled                   : False
MailNickname                  : ADSyncOperators
OnPremisesSecurityIdentifier  : S-1-5-21-2695029449-1154706203-1063139792-1243
ProxyAddresses                : {}
SecurityEnabled               : True
GroupTypes                    : {}
MembershipRule                :
MembershipRuleProcessingState :


Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b
Description                   :
OnPremisesSyncEnabled         :
DisplayName                   : Project Icarus
OnPremisesLastSyncDateTime    :
Mail                          :
MailEnabled                   : False
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6
OnPremisesSecurityIdentifier  :
ProxyAddresses                : {}
SecurityEnabled               : True
GroupTypes                    : {DynamicMembership}
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece"))
MembershipRuleProcessingState : On

このコマンドは、Microsoft Entra ID 内のすべてのグループを取得します。

例 2: ID を使用して特定のグループを取得する

PS C:\> Get-AzureADMSGroup -Id "d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b"

Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b
Description                   :
OnPremisesSyncEnabled         :
DisplayName                   : Project Icarus
OnPremisesLastSyncDateTime    :
Mail                          :
MailEnabled                   : False
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6
OnPremisesSecurityIdentifier  :
ProxyAddresses                : {}
SecurityEnabled               : True
GroupTypes                    : {DynamicMembership}
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece"))
MembershipRuleProcessingState : On

このコマンドは、指定された ID を持つグループの情報を取得します。

パラメーター

-All

true の場合は、すべてのグループを返します。 false の場合は、Top パラメーターで指定されたオブジェクトの数を返します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Filter

グループのセットに一致する oData v3.0 フィルター文字列を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Id

このコマンドレットが取得するグループの ID を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SearchString

検索文字列を指定します。 このコマンドレットは、検索文字列に一致する DisplayName 属性または Description 属性を持つグループを取得します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Top

この cmldet が取得するレコードの最大数を指定します。 既定値は 100 です。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

String

System.Nullable'1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

出力

Object

メモ

Microsoft Graph PowerShell への Get-AzureADMSGroup の移行ガイド を参照してください。

このコマンドレットは現在パブリック プレビュー段階です。 コマンドレットがパブリック プレビュー段階にある間に、予期しない影響を及ぼす可能性があるコマンドレットに変更を加える場合があります。 運用環境では、このコマンドレットを使用しないことをお勧めします。