New-AzureADMSGroup

  • 參考
模組:
AzureAD

建立 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

New-AzureADMSGroup Cmdlet 會建立 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

指定群組內容和成員清單的可見性。 此參數可以採用下列其中一個值：

  • 「公用」- 任何人都可以檢視群組的內容
  • “Private” - 只有成員可以檢視群組的內容
  • “HiddenMembership” - 只有成員可以檢視群組的內容，且只能檢視成員、擁有者、全域/公司管理員、使用者管理員和技術服務人員可以檢視群組的成員清單。

如果未提供任何值，預設值會是 “Public”。

注意：

  • 此參數僅適用於 groupType 設定為 「Unified」 的群組。
  • 如果群組的這個屬性設定為 「HiddenMembership」，則稍後無法變更。
  • 任何人都可以加入已將此屬性設定為 「公用」的群組。 如果屬性設定為 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 的移轉指南。

此 Cmdlet 目前處於公開預覽狀態。 當 Cmdlet 處於公開預覽狀態時，我們可能會對可能會有非預期效果的 Cmdlet 進行變更。 建議您不要在生產環境中使用此 Cmdlet。