你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
New-AzureADUserAppRoleAssignment
向应用程序角色分配用户。
语法
New-AzureADUserAppRoleAssignment
-ObjectId <String>
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
-Id <String>
-PrincipalId <String>
-ResourceId <String>
[<CommonParameters>] 说明
New-AzureADUserAppRoleAssignment cmdlet 将用户分配到 Azure Active Directory (AD) 中的应用程序角色。
示例
示例 1：将用户分配到没有角色的应用程序
# Get AppId of the app to assign the user to
$appId = Get-AzureADApplication -SearchString "<Your App's display name>"
# Get the user to be added
$user = Get-AzureADUser -searchstring "<Your user's UPN>"
# Get the service principal for the app you want to assign the user to
$servicePrincipal = Get-AzureADServicePrincipal -Filter "appId eq '$appId'"
# Create the user app role assignment
New-AzureADUserAppRoleAssignment -ObjectId $user.ObjectId -PrincipalId $user.ObjectId -ResourceId $servicePrincipal.ObjectId -Id ([Guid]::Empty)此命令将用户分配给 和 应用程序，t 具有任何角色。
示例 2：将用户分配到应用程序中的特定角色
$username = "<You user's UPN>"
$appname = "<Your App's display name>"
$spo = Get-AzureADServicePrincipal -Filter "Displayname eq '$appname'"
$user = Get-AzureADUser -ObjectId $username
New-AzureADUserAppRoleAssignment -ObjectId $user.ObjectId -PrincipalId $user.ObjectId -ResourceId $spo.ObjectId -Id $spo.Approles[1].id此 cmdlet 向指定用户分配使用 $spo指定 ID 的应用程序角色。Approles[1].id。有关如何检索应用程序角色的详细信息，请参阅 -Id 参数的说明。
参数
-Id
要分配的应用角色的 ID。 为没有任何角色的应用程序创建新的应用角色分配时提供空 GUID，或者提供要分配给用户的角色的 ID。
可以通过检查应用程序对象的 AppRoles 属性来检索应用程序的角色：
Get-AzureadApplication -SearchString “应用程序显示名称” |选择 Approles |佛罗里达州
此 cmdlet 返回应用程序中定义的角色列表：
AppRoles： {class AppRole { AllowedMemberTypes： System.Collections.Generic.List1[System.String] Description： description for <this role> DisplayName： <display name for this role> Id： 97e244a 2-6ccd-4312-9de6-ecb21884c9f7 IsEnabled： True Value： <Value that will be 传输作为此角色> 的令牌中的声明 } }
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-InformationAction
指定此 cmdlet 如何响应信息事件。 此参数的可接受值为：
- 继续
- 忽略
- 查询
- SilentlyContinue
- 停止
- 挂起
| 类型: | ActionPreference |
| 别名: | infa |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InformationVariable
指定信息变量。
| 类型: | String |
| 别名: | iv |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ObjectId
在 Azure AD 中将新应用角色指定为 UPN 或 ObjectId) (用户 ID
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-PrincipalId
向其分配新应用角色的主体的对象 ID。 向用户分配新角色时，请提供用户的对象 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ResourceId
向其分配用户角色的应用程序的服务主体的对象 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
备注
请参阅 New-AzureADUserAppRoleAssignment 到 Microsoft Graph PowerShell 的迁移指南。