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 パラメーターで指定されたオブジェクトの数を返します。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Filter

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Top

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

入力

String

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

出力

Object

メモ

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

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