Get-EntraBetaObjectSetting
获取对象设置。
语法
GetQuery (默认值)
Get-EntraBetaObjectSetting
-TargetType <String>
-TargetObjectId <String>
[-Top <Int32>]
[-All]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraBetaObjectSetting
-Id <String>
-TargetType <String>
-TargetObjectId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
说明
该 Get-EntraBetaObjectSetting cmdlet 从Microsoft Entra ID检索对象设置。
示例
示例 1:从Microsoft Entra ID检索对象设置
Connect-Entra -Scopes 'Directory.Read.All'
$group = Get-EntraBetaGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraBetaObjectSetting -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-EntraBetaGroup -Filter "DisplayName eq 'Sales and Marketing'"
$setting = Get-EntraBetaObjectSetting -TargetType 'Groups' -TargetObjectId $group.Id | Where-Object {$_.displayName -eq 'Group.Unified.Guest'}
Get-EntraBetaObjectSetting -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检索前一个对象设置
Connect-Entra -Scopes 'Directory.Read.All'
$group = Get-EntraBetaGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraBetaObjectSetting -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检索前一个对象设置。 您可以将 -Limit 用作 -Top 的别名。
-
-TargetType参数指定目标类型。 -
-TargetObjectId参数指定目标对象的 ID。
示例 4:从Microsoft Entra ID检索所有对象设置
Connect-Entra -Scopes 'Directory.Read.All'
$group = Get-EntraBetaGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraBetaObjectSetting -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。
参数
-All
列出所有页面。
参数属性
| 类型: | System.Management.Automation.SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Id
指定设置对象的 ID。
参数属性
| 类型: | System.String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
GetById
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Property
指定要返回的属性。
参数属性
| 类型: | System.String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | Select |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-TargetObjectId
指定目标对象的 ID。
参数属性
| 类型: | System.String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-TargetType
指定目标类型。
参数属性
| 类型: | System.String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Top
指定要返回的最大记录数。
参数属性
| 类型: | System.Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | Limit |
参数集
GetQuery
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。