共用方式為


Set-AzureADMSGroup

設定現有 Azure AD 群組的屬性。

語法

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

Description

Set-AzureADMSGroup Cmdlet 會設定現有 Azure Active Directory (Azure AD) 群組的屬性。

範例

範例 1:更新群組的顯示名稱

PS C:\> Set-AzureADMSGroup -Id '0260d811-6674-4e65-9674-f511abcb4f7b' -DisplayName 'Tailspin Toys Ltd'

此命令會更新指定群組的顯示名稱。

參數

-Description

指定群組的描述。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisplayName

指定群組的顯示名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-GroupTypes

指定群組是動態群組。 若要建立動態群組,請指定 DynamicMembership 的值。

類型:List<T>[String]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

指定群組的物件識別碼。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-IsAssignableToRole

此屬性只能在建立群組時設定,而且無法在現有群組上修改。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-MailEnabled

指出此群組是否已啟用郵件。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-MailNickname

指定群組的郵件昵稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SecurityEnabled

指出群組是否已啟用安全性。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Visibility

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

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

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

注意:

  • 此參數僅適用於 groupType 設定為 「Unified」 的群組。
  • 如果群組的這個屬性設定為 「HiddenMembership」,則稍後無法變更。
  • 任何人都可以加入已將此屬性設定為 「公用」的群組。 如果屬性設定為 Private 或 HiddenMembership,則只有擁有者 () 可以將新成員新增至群組,並要求加入群組需要核准擁有者 () 。
類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

String

輸出

Object