Поделиться через

New-AzureADMSGroup

  • Ссылка
Модуль:
AzureAD

Создает группу Azure AD.

Синтаксис

New-AzureADMSGroup
   [-Description <String>]
   -DisplayName <String>
   [-IsAssignableToRole <Boolean>]
   -MailEnabled <Boolean>
   -MailNickname <String>
   -SecurityEnabled <Boolean>
   [-GroupTypes <System.Collections.Generic.List`1[System.String]>]
   [-Visibility <String>]
   [<CommonParameters>]

Описание

Командлет New-AzureADMSGroup создает группу Azure Active Directory (Azure AD).

Примеры

Пример. Создание группы, назначаемой роли

PS C:\> New-AzureADMSGroup -DisplayName "HelpDesk admin group" -Description "Group assignable to role" -MailEnabled $False -MailNickname "helpDeskAdminGroup" -SecurityEnabled $True -IsAssignableToRole $True -Visibility "Private"

Id                            : 1026185e-25df-4522-a380-7ab697a7241c
Description                   : Group assignable to role
OnPremisesSyncEnabled         : 
DisplayName                   : HelpDesk admin group
Mail                          : 
MailEnabled                   : False
IsAssignableToRole            : True 
MailNickname                  : helpDeskAdminGroup
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {}

Параметры

-Description

Указывает описание группы.

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

-DisplayName

Указывает отображаемое имя группы.

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

-GroupTypes

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

Примечания.

  • В настоящее время этот параметр нельзя использовать для создания динамических групп. Чтобы создать динамическую группу в PowerShell, необходимо использовать модуль Предварительной версии Azure AD.
Тип:List<T>[String]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IsAssignableToRole

Указывает, может ли группа быть назначена роли. Это свойство может быть задано только во время создания группы и не может быть изменено в существующей группе.

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

-MailEnabled

Указывает, включена ли эта группа почты.

В настоящее время вы не можете создавать группы с поддержкой почты в Azure AD.

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

-MailNickname

Указывает почтовый псевдоним для группы. Если mailEnabled $False необходимо по-прежнему указывать почтовый псевдоним.

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

-SecurityEnabled

Указывает, включена ли в группе безопасность. Для групп безопасности это значение должно быть $True.

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

-Visibility

Указывает видимость содержимого и списка участников группы. Этот параметр может принимать одно из следующих значений:

  • "Общедоступный" — любой пользователь может просматривать содержимое группы.
  • "Частный" — только участники могут просматривать содержимое группы.
  • HiddenMembership — просматривать содержимое группы могут только участники, а список участников группы могут просматривать только участники, владельцы, глобальные администраторы или администраторы компании, администраторы пользователей и администраторы службы технической поддержки.

Если значение не указано, по умолчанию используется значение "Public".

Примечания.

  • Этот параметр действителен только для групп, для которых для параметра groupType задано значение Unified.
  • Если для группы задано значение HiddenMembership, его нельзя изменить позже.
  • Любой пользователь может присоединиться к группе, для которого для этого атрибута задано значение "Public". Если атрибут имеет значение Private или HiddenMembership, только владельцы могут добавлять новых участников в группу, а запросы на присоединение к группе требуют утверждения владельцев.
Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

None

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

Object

Примечания

См. руководство по миграции New-AzureADMSGroup в Microsoft Graph PowerShell.

В настоящее время этот командлет находится в общедоступной предварительной версии. Пока командлет находится в общедоступной предварительной версии, мы можем внести в него изменения, которые могут привести к непредвиденным последствиям. Не рекомендуется использовать этот командлет в рабочей среде.