Add-EntraDirectoryRoleMember
將成員加入目錄角色。
語法
Default (預設值)
Add-EntraDirectoryRoleMember
-DirectoryRoleId <String>
-MemberId <String>
[<CommonParameters>]
Description
Add-EntraDirectoryRoleMember指令小程式會為 Microsoft Entra ID 角色新增成員。
在委派情境中，登入使用者必須擁有支援的 Microsoft Entra 角色或具備必要權限的自訂角色。 此作業所需的最低角色包括：
- 特殊權限角色管理員
範例
範例 1：將成員加入 Microsoft Entra ID 角色
Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$directoryRole = Get-EntraDirectoryRole -Filter "DisplayName eq 'Helpdesk Administrator'"
$user = Get-EntraUser -UserId 'SawyerM@Contoso.com'
Add-EntraDirectoryRoleMember -DirectoryRoleId $directoryRole.Id -MemberId $user.Id
此範例為目錄角色新增成員。
-
DirectoryRoleId參數指定該成員所加入的目錄角色的 ID。 使用 Get-EntraDirectoryRole 指令來取得目錄角色的詳細資訊。 -
MemberId參數指定要指派為擁有者/管理者/成員的 Microsoft Entra ID 物件的 ID。
參數
-DirectoryRoleId
指定 Microsoft Entra ID 中目錄角色的 ID。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ObjectId (物件識別碼) |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-MemberId
指定 Microsoft Entra ID 物件的 ID，指定為擁有者/管理者/成員。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | RefObjectId |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。