Get-EntraObjectSetting

Возвращает параметр объекта.

Синтаксис

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 Параметр задает идентификатор целевого объекта.

Пример 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 Параметр задает идентификатор объекта settings.

Пример 3. Получение параметра верхнего объекта из 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 -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 Параметр задает идентификатор целевого объекта.

Пример 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 Параметр задает идентификатор целевого объекта.

Пример 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 Параметр задает идентификатор пользователя.

Параметры

-All

Вывод списка всех страниц.

Свойства параметров

Тип:System.Management.Automation.SwitchParameter
Значение по умолчанию:False
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Id

Указывает идентификатор объекта settings.

Свойства параметров

Тип:System.String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

GetById
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Property

Указывает свойства, возвращаемые.

Свойства параметров

Тип:

System.String[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Select

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-TargetObjectId

Указывает идентификатор целевого объекта.

Свойства параметров

Тип:System.String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-TargetType

Указывает целевой тип.

Свойства параметров

Тип:System.String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Top

Указывает максимальное количество возвращаемых записей.

Свойства параметров

Тип:System.Int32
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Ограничение

Наборы параметров

GetQuery
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.