Update-AzADGroup

Модуль:

Az.Resources

обновление сущности в группах

Синтаксис

Update-AzADGroup
      -ObjectId <String>
      [-AdditionalProperties <Hashtable>]
      [-AppRoleAssignment <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>]
      [-Classification <String>]
      [-CreatedOnBehalfOf <IMicrosoftGraphDirectoryObject>]
      [-DeletedDateTime <DateTime>]
      [-Description <String>]
      [-DisplayName <String>]
      [-GroupType <String[]>]
      [-HasMembersWithLicenseError]
      [-IsArchived]
      [-IsAssignableToRole]
      [-MailEnabled]
      [-MailNickname <String>]
      [-MembershipRule <String>]
      [-MembershipRuleProcessingState <String>]
      [-PermissionGrant <IMicrosoftGraphResourceSpecificPermissionGrant[]>]
      [-PreferredDataLocation <String>]
      [-PreferredLanguage <String>]
      [-SecurityEnabled]
      [-SecurityIdentifier <String>]
      [-Theme <String>]
      [-Visibility <String>]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADGroup
      -ObjectId <String>
      -JsonFilePath <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADGroup
      -ObjectId <String>
      -JsonString <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

обновление сущности в группах

Примеры

Пример 1. Обновление описания группы

Update-AzADGroup -ObjectId $objectid -Description $description

Обновление описания для группы.

Параметры

-AdditionalProperties

Дополнительные параметры

Тип:	Hashtable
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AppRoleAssignment

Представляет роли приложения, которые группа была предоставлена приложению. Поддерживает $expand.

Тип:	IMicrosoftGraphAppRoleAssignmentAutoGenerated[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Classification

Описывает классификацию для группы (например, низкий, средний или высокий уровень влияния на бизнес). Допустимые значения для этого свойства определяются путем создания значения параметра ClassificationList на основе определения шаблона. Возвращается по умолчанию. Поддерживает $filter (eq, ne, NOT, ge, le, startsWith).

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CreatedOnBehalfOf

Представляет объект Azure Active Directory. Тип directoryObject является базовым типом для многих других типов сущностей каталога.

Тип:	IMicrosoftGraphDirectoryObject
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultProfile

Параметр DefaultProfile не работает. Используйте параметр SubscriptionId, если он доступен при выполнении командлета в другой подписке.

Тип:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DeletedDateTime

.

Тип:	DateTime
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Description

Необязательное описание группы. Возвращается по умолчанию. Поддерживает $filter (eq, ne, NOT, ge, le, startsWith) и $search.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisplayName

Имя, отображаемое в каталоге

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-GroupType

Указывает тип группы и его членство. Если коллекция содержит единую, группа является группой Microsoft 365; в противном случае это группа безопасности или группа рассылки. Дополнительные сведения см. в обзоре групп. Если коллекция включает DynamicMembership, группа имеет динамическое членство; в противном случае членство является статическим. Возвращается по умолчанию. Поддерживает $filter (eq, NOT).

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-HasMembersWithLicenseError

Указывает, есть ли члены этой группы с ошибками лицензии из назначения лицензий на основе группы. Это свойство никогда не возвращается для операции GET. Его можно использовать в качестве аргумента $filter для получения групп, имеющих членов с ошибками лицензии (т. е. фильтрация по этому свойству true). Поддерживает $filter (eq).

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IsArchived

.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IsAssignableToRole

Указывает, может ли эта группа быть назначена роли Azure Active Directory. Это свойство можно задать только при создании группы и неизменяемо. Если задано значение true, свойство securityEnabled также должно иметь значение true, а группа не может быть динамической группой (то есть groupTypes не может содержать DynamicMembership). Это свойство можно задать только вызывающим пользователям в ролях глобального администратора и администраторов привилегированных ролей. Вызывающий объект также должен быть назначен разрешение Directory.AccessAsUser.All для задания этого свойства. Дополнительные сведения см. в статье "Использование группы для управления назначениями ролей Azure AD" по умолчанию. Поддерживает $filter (eq, ne, NOT).

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-JsonFilePath

Путь к json-файлу, предоставленному операции обновления

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-JsonString

Строка JSON, предоставленная операции обновления

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MailEnabled

Указывает, включена ли группа. Возвращается по умолчанию. Поддерживает $filter (eq, ne, NOT).

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MailNickname

Псевдоним почты для группы, уникальный в организации. Это свойство необходимо указать при создании группы. Эти символы нельзя использовать в mailNickName: @()/[]';:.<>,ПРОБЕЛ. Возвращается по умолчанию. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MembershipRule

Правило, определяющее участников для этой группы, если группа является динамической группой (groupTypes содержит DynamicMembership). Дополнительные сведения о синтаксисе правила членства см. в синтаксисе правил членства. Возвращается по умолчанию. Поддерживает $filter (eq, ne, NOT, ge, le, startsWith).

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MembershipRuleProcessingState

Указывает, включена ли или приостановлена обработка динамического членства. Возможные значения : On или Paused. Возвращается по умолчанию. Поддерживает $filter (eq, ne, NOT, in).

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ObjectId

ключ: идентификатор группы

Тип:	String
Aliases:	GroupId
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PassThru

Возвращает значение true, когда команда завершается успешно

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PermissionGrant

Разрешения, предоставленные для группы определенному приложению. Поддерживает $expand.

Тип:	IMicrosoftGraphResourceSpecificPermissionGrant[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PreferredDataLocation

Предпочтительное расположение данных для группы. Дополнительные сведения см. в статье OneDrive Online Multi-Geo. Возвращается по умолчанию.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PreferredLanguage

Предпочтительный язык для группы Microsoft 365. Должен соответствовать коду ISO 639-1; например,en-US'. Возвращается по умолчанию. Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SecurityEnabled

Указывает, является ли группа группой безопасности. Возвращается по умолчанию. Поддерживает $filter (eq, ne, NOT, in).

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SecurityIdentifier

Идентификатор безопасности группы, используемый в сценариях Windows. Возвращается по умолчанию.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Theme

Задает цветовую тему группы Microsoft 365. Возможные значения: тель, фиолетовый, зеленый, синий, розовый, оранжевый или красный. Возвращается по умолчанию.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Visibility

Указывает политику объединения групп и видимость содержимого группы для групп. Возможные значения: Private, Public или Hiddenmembership. Hiddenmembership можно задать только для групп Microsoft 365 при создании групп. Его нельзя обновить позже. Другие значения видимости можно обновить после создания группы. Если значение видимости не указано во время создания группы в Microsoft Graph, группа безопасности создается как частная по умолчанию, а группа Microsoft 365 — общедоступная. Дополнительные сведения см. в параметрах видимости группы. Возвращается по умолчанию.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Выходные данные

Boolean