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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-GroupTypes

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

Примечания.

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

-IsAssignableToRole

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailEnabled

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

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

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MailNickname

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SecurityEnabled

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

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Visibility

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

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

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

Примечания.

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

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

None

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

Object

Примечания

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

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