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 |