New-AzureADMSGroup

  • Reference
Modul:
AzureAD

Vytvoří skupinu Azure AD.

Syntax

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>]

Description

Rutina New-AzureADMSGroup vytvoří skupinu Azure Active Directory (Azure AD).

Příklady

Příklad: Vytvoření skupiny přiřaditelné k roli

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                    : {}

Parametry

-Description

Určuje popis skupiny.

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

-DisplayName

Určuje zobrazovaný název skupiny.

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

-GroupTypes

Určuje, že skupina je sjednocená nebo dynamická skupina.

Poznámky:

  • Tento parametr v současné době nelze použít k vytváření dynamických skupin. Pokud chcete vytvořit dynamickou skupinu v PowerShellu, musíte použít modul Azure AD Preview.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsAssignableToRole

Určuje, jestli je možné přiřadit skupinu k roli. Tuto vlastnost lze nastavit pouze při vytváření skupiny a nelze ji upravit u existující skupiny.

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

-MailEnabled

Určuje, jestli je tato skupina povolená pošta.

V současné době nemůžete v Azure AD vytvářet skupiny s povolenou poštou.

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

-MailNickname

Určuje poštovní přezdívku skupiny. Pokud je mailEnabled $False musíte zadat e-mailovou přezdívku.

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

-SecurityEnabled

Označuje, jestli je ve skupině povolené zabezpečení. U skupin zabezpečení musí být tato hodnota $True.

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

-Visibility

Určuje viditelnost obsahu skupiny a seznamu členů. Tento parametr může mít jednu z následujících hodnot:

  • "Veřejný" – obsah skupiny může zobrazit kdokoli.
  • "Soukromé" – obsah skupiny můžou zobrazit jenom členové.
  • HiddenMembership – obsah skupiny můžou zobrazit jenom členové a seznam členů skupiny můžou zobrazit jenom členové, vlastníci, globální správce nebo správce společnosti, správce uživatelů a helpdesk správci.

Pokud není zadaná žádná hodnota, bude výchozí hodnota "Public".

Poznámky:

  • Tento parametr je platný pouze pro skupiny, které mají groupType nastavenou na "Unified".
  • Pokud má skupina tento atribut nastavený na HiddenMembership, nebude možné ho později změnit.
  • Kdokoli se může připojit ke skupině, která má tento atribut nastavený na "Public". Pokud je atribut nastavený na Private nebo HiddenMembership, můžou do skupiny přidávat nové členy jenom vlastníci a žádosti o připojení ke skupině potřebují souhlas vlastníka nebo vlastníků.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

None

Výstupy

Object

Poznámky

Projděte si průvodce migrací pro New-AzureADMSGroup do Prostředí Microsoft Graph PowerShell.

Tato rutina je aktuálně ve verzi Public Preview. Zatímco je rutina ve verzi Public Preview, můžeme v této rutině provádět změny, které by mohly mít neočekávané účinky. Doporučujeme nepoužívat tuto rutinu v produkčním prostředí.