Update-AzADGroup
Обновление сущности в группах
Синтаксис
UpdateExpanded (По умолчанию)
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>]
UpdateViaJsonFilePath
Update-AzADGroup
-ObjectId <String>
-JsonFilePath <String>
[-DefaultProfile <PSObject>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateViaJsonString
Update-AzADGroup
-ObjectId <String>
-JsonString <String>
[-DefaultProfile <PSObject>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Обновление сущности в группах
Примеры
Пример 1. Обновление описания группы
Update-AzADGroup -ObjectId $objectid -Description $description
Обновление описания для группы.
Параметры
-AdditionalProperties
Дополнительные параметры
Свойства параметров
Тип: Hashtable
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-AppRoleAssignment
Представляет роли группе, предоставленные пользователю для приложения.
Поддерживает $expand.
Свойства параметров
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Classification
Описывает классификацию для группы (например, низкий, средний или высокий уровень влияния на бизнес).
Допустимые значения для этого свойства определяются путем создания значения параметра ClassificationList на основе определения шаблона. Возвращается по умолчанию.
Поддерживает $filter (eq, ne, NOT, ge, le, startsWith).
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Cf
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-CreatedOnBehalfOf
Представляет объект Azure Active Directory.
Тип directoryObject является базовым типом для многих других типов сущностей каталога.
Свойства параметров
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-DefaultProfile
Параметр DefaultProfile не работает.
Используйте параметр SubscriptionId, если он доступен при выполнении командлета в другой подписке.
Свойства параметров
Тип: PSObject
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: AzureRMContext, AzureCredential
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-DeletedDateTime
.
Свойства параметров
Тип: DateTime
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Description
Необязательное описание для группы.
Возвращается по умолчанию.
Поддерживает $filter (eq, ne, NOT, ge, le, startsWith) и $search.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-DisplayName
Имя, отображаемое в каталоге
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-GroupType
Задает тип группы и участие в ней.
Если коллекция содержит единую, группа является Microsoft 365 группой; в противном случае это группа безопасности или группа распространения.
Дополнительные сведения см. в обзоре групп. Если коллекция включает DynamicMembership, группа имеет динамическое членство; в противном случае членство является статическим.
Возвращается по умолчанию.
Поддерживает $filter (eq, NOT).
Свойства параметров
Тип: String [ ]
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-HasMembersWithLicenseError
Указывает, есть ли в этой группе участники с ошибками лицензий после группового назначения лицензий.
Это свойство никогда не возвращается при использовании операции GET.
Его можно использовать в качестве аргумента $filter для получения групп, включающих участников с ошибками лицензии (т. е. фильтру для этого свойства присвоено значчение true).
Поддерживает $filter (eq).
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-IsArchived
.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-IsAssignableToRole
Указывает, может ли эта группа быть назначена роли Azure Active Directory. Это свойство можно задать только при создании группы и неизменяемо.
Если задано значение true, свойство securityEnabled также должно иметь значение true, а группа не может быть динамической группой (то есть groupTypes не может содержать DynamicMembership).
Это свойство можно задать только вызывающим пользователям в ролях администратора глобальный администратор и привилегированных ролей.
Вызывающий объект также должен быть назначен разрешение Directory.AccessAsUser.All для задания этого свойства.
Дополнительные сведения см. в разделе "Использование группы для управления назначениями ролей AD Azure AD" по умолчанию.
Поддерживает $filter (eq, ne, NOT).
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-JsonFilePath
Путь к json-файлу, предоставленному операции обновления
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateViaJsonFilePath
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-JsonString
Строка JSON, предоставленная операции обновления
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateViaJsonString
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-MailEnabled
Указывает, включена ли для этой группы поддержка почты.
Возвращается по умолчанию.
Поддерживает $filter (eq, ne, NOT).
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-MailNickname
Почтовый псевдоним для группы (уникальный в организации).
Это свойство должно быть указано при создании группы.
Эти символы нельзя использовать в mailNickName: @()/[]';:.<>,SPACE.
Возвращается по умолчанию.
Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-MembershipRule
Правило, определяющее членов этой группы, если группа является динамической (groupTypes содержит DynamicMembership).
Дополнительные сведения о синтаксисе правила членства см. в синтаксисе правил членства.
Возвращается по умолчанию.
Поддерживает $filter (eq, ne, NOT, ge, le, startsWith).
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-MembershipRuleProcessingState
Указывает, включена или приостановлена динамическая обработка участия.
Возможные значения: Включено или Приостановлено.
Возвращается по умолчанию.
Поддерживает $filter (eq, ne, NOT, in).
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-ObjectId
ключ: идентификатор группы
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: ИдентификаторГруппы
Наборы параметров
(All)
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-PassThru
Возвращает значение true, когда команда завершается успешно
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-PermissionGrant
Разрешения, предоставленные для группы определенному приложению.
Поддерживает $expand.
Свойства параметров
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-PreferredDataLocation
Предпочтительное расположение данных для группы.
Дополнительные сведения см. в разделе OneDrive Online Multi-Geo.
Возвращается по умолчанию.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-PreferredLanguage
Предпочитаемый язык для группы Microsoft 365.
Должен соответствовать коду ISO 639-1; например,en-US'.
Возвращается по умолчанию.
Поддерживает $filter (eq, ne, NOT, ge, le, in, startsWith).
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-SecurityEnabled
Указывает, является ли эта группа группой безопасности.
Возвращается по умолчанию.
Поддерживает $filter (eq, ne, NOT, in).
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-SecurityIdentifier
Идентификатор безопасности группы, используемый в сценариях Windows.
Возвращается по умолчанию.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Theme
Указывает цветовую тему группы Microsoft 365.
Возможные значения: тель, фиолетовый, зеленый, синий, розовый, оранжевый или красный.
Возвращается по умолчанию.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Visibility
Указывает политику присоединения к группе и видимость содержимого для групп.
Возможные значения: Private, Public или Hiddenmembership.
Hiddenmembership можно задать только для групп Microsoft 365 при создании групп.
Обновление невозможно выполнить позже.
Другие значения видимости можно обновлять после создания группы.
Если значение видимости не указано во время создания группы в Microsoft Graph, группа безопасности создается как частная по умолчанию и Microsoft 365 группа является общедоступной.
Дополнительные сведения см. в параметрах видимости группы.
Возвращается по умолчанию.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
UpdateExpanded
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-WhatIf
Показывает, что произойдет, если командлет будет запущен.
Командлет не запускается.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Wi
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters .
Выходные данные