Set-AzureADMSGroup

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

Syntax

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

指定群組的描述。

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:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupTypes

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

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

指定群組的物件識別碼。

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

-IsAssignableToRole

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

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

-MailEnabled

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

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

-MailNickname

指定群組的郵件昵稱。

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

-SecurityEnabled

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

Type:Boolean
Position:Named
Default value:None
Required:False
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

輸入

String

輸出

Object