共用方式為


Add-AzureRmADGroupMember

將使用者新增至現有的AD群組。

警告

自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源

語法

Add-AzureRmADGroupMember
   -MemberObjectId <Guid[]>
   -TargetGroupObjectId <Guid>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberObjectId <Guid[]>
   -TargetGroupDisplayName <String>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberObjectId <Guid[]>
   -TargetGroupObject <PSADGroup>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberUserPrincipalName <String[]>
   -TargetGroupDisplayName <String>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberUserPrincipalName <String[]>
   -TargetGroupObject <PSADGroup>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberUserPrincipalName <String[]>
   -TargetGroupObjectId <Guid>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

將使用者新增至現有的AD群組。

範例

範例 1 - 依物件識別碼將使用者新增至群組

PS C:\> Add-AzureRmADGroupMember -MemberObjectId D9076BBC-D62C-4105-9C78-A7F5BC4A3405 -TargetGroupObjectId 85F89C90-780E-4AA6-9F4F-6F268D322EEE

將對象標識碼為 'D9076BBC-D62C-4105-9C78-A7F5BC4A3405' 的使用者新增至對象標識符為 '85F89C90-780E-4AA6-9F4F-6F268D322EEE' 的群組。

範例 2 - 透過管線將使用者新增至群組

PS C:\> Get-AzureRmADGroup -ObjectId 85F89C90-780E-4AA6-9F4F-6F268D322EEE | Add-AzureRmADGroupMember -MemberObjectId D9076BBC-D62C-4105-9C78-A7F5BC4A3405

取得對象標識碼為 '85F89C90-780E-4AA6-9F4F-6F268D322EEE' 的群組,並將它傳送至 Add-AzureRmADGroupMember Cmdlet,將使用者新增至該群組。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-MemberObjectId

成員的物件識別碼。

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

-MemberUserPrincipalName

要新增至群組之成員的UPN。

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

-PassThru

如果命令成功,則指定這會傳回 true。

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

-TargetGroupDisplayName

要加入成員之群組的顯示名稱。

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

-TargetGroupObject

要加入成員之群組的物件表示法。

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

-TargetGroupObjectId

要加入成員之群組的物件標識碼。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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

輸入

PSADGroup

參數:TargetGroupObject (ByValue)

輸出

Boolean