Get-EntraObjectSetting

モジュール:
Microsoft.Entra.Groups Module v1.3

オブジェクト設定を取得します。

構文

GetQuery (既定) 

Get-EntraObjectSetting

    -TargetType <String>
    -TargetObjectId <String>
    [-Top <Int32>]
    [-All]
    [<CommonParameters>]

GetById 

Get-EntraObjectSetting

    -Id <String>
    -TargetType <String>
    -TargetObjectId <String>
    [-All]
    [<CommonParameters>]

説明

Get-EntraObjectSetting コマンドレットは、Microsoft Entra IDからオブジェクト設定を取得します。

例

例 1: Microsoft Entra IDからオブジェクト設定を取得する

Connect-Entra -Scopes 'Directory.Read.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraObjectSetting -TargetType 'Groups' -TargetObjectId $group.Id

Id                                   DisplayName         TemplateId
--                                   -----------         ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Group.Unified.Guest 22cc22cc-dd33-ee44-ff55-66aa66aa66aa

このコマンドは、Microsoft Entra IDからオブジェクト設定を取得します。

  • -TargetType パラメーターは、ターゲットの型を指定します。
  • -TargetObjectId パラメーターは、ターゲット オブジェクトの ID を指定します。

例 2: Microsoft Entra IDから特定のオブジェクト設定を取得する

Connect-Entra -Scopes 'Directory.Read.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
$setting = Get-EntraObjectSetting -TargetType 'Groups' -TargetObjectId $group.Id | Where-Object {$_.displayName -eq 'Group.Unified.Guest'}
Get-EntraObjectSetting -TargetType 'Groups' -TargetObjectId $group.Id -Id $setting.Id

Id                                   DisplayName         TemplateId
--                                   -----------         ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Group.Unified.Guest 22cc22cc-dd33-ee44-ff55-66aa66aa66aa

このコマンドは、Microsoft Entra IDから特定のオブジェクト設定を取得します。

  • -TargetType パラメーターは、ターゲットの型を指定します。
  • -TargetObjectId パラメーターは、ターゲット オブジェクトの ID を指定します。
  • -Id パラメーターは、設定オブジェクトの ID を指定します。

例 3: Microsoft Entra IDから上位 1 つのオブジェクト設定を取得する

Connect-Entra -Scopes 'Directory.Read.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraObjectSetting -TargetType 'Groups' -TargetObjectId $group.Id -Top 1

Id                                   DisplayName         TemplateId
--                                   -----------         ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Group.Unified.Guest 22cc22cc-dd33-ee44-ff55-66aa66aa66aa

このコマンドは、Microsoft Entra IDから上位 1 つのオブジェクト設定を取得します。 -Limitのエイリアスとして-Topを使用できます。

  • -TargetType パラメーターは、ターゲットの型を指定します。
  • -TargetObjectId パラメーターは、ターゲット オブジェクトの ID を指定します。

例 4: Microsoft Entra IDからすべてのオブジェクト設定を取得する

Connect-Entra -Scopes 'Directory.Read.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraObjectSetting -TargetType 'Groups' -TargetObjectId $group.Id -All

Id                                   DisplayName         TemplateId
--                                   -----------         ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Group.Unified.Guest 22cc22cc-dd33-ee44-ff55-66aa66aa66aa

このコマンドは、オブジェクト設定のすべてのレコードをMicrosoft Entra IDから取得します。

  • -TargetType パラメーターは、ターゲットの型を指定します。
  • -TargetObjectId パラメーターは、ターゲット オブジェクトの ID を指定します。

例 5: ユーザー オブジェクトの設定を取得する

Connect-Entra -Scopes 'Directory.Read.All'
$user = Get-EntraUser -UserId 'AdeleV@Contoso.com'
Get-EntraObjectSetting -TargetType 'Users' -TargetObjectId $user.Id

Id ContributionToContentDiscoveryAsOrganizationDisabled ContributionToContentDiscoveryDisabled
-- ---------------------------------------------------- --------------------------------------
   False                                                False

このコマンドは、ユーザー オブジェクトの設定を取得します。

  • -TargetType パラメーターは、ユーザー ターゲットの種類を指定します。
  • -TargetObjectId パラメーターは、ユーザーの ID を指定します。

パラメーター

-All

すべてのページを一覧表示します。

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

型:System.Management.Automation.SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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

-Id

設定オブジェクトの ID を指定します。

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

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

パラメーター セット

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

-Property

返されるプロパティを指定します。

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

型:

System.String[]

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

パラメーター セット

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

-TargetObjectId

ターゲット オブジェクトの ID を指定します。

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

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

パラメーター セット

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

-TargetType

ターゲットの種類を指定します。

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

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

パラメーター セット

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

-Top

返されるレコードの最大数を指定します。

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

型:System.Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:極限

パラメーター セット

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

CommonParameters

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