New-AzureADServiceAppRoleAssignment

New-AzureADServiceAppRoleAssignment
    -ObjectId <String>
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    -Id <String>
    -PrincipalId <String>
    -ResourceId <String>
    [<CommonParameters>]

El cmdlet New-AzureADServiceAppRoleAssignment asigna un rol de aplicación de una entidad de servicio de recursos a un usuario, un grupo u otra entidad de servicio. Los roles de aplicación asignados a entidades de servicio también se conocen como permisos de aplicación.

PS C:\> Connect-AzureAD
PS C:\> New-AzureADServiceAppRoleAssignment -ObjectId $resource.ObjectId -ResourceId $resource.ObjectId -Id $appRole.Id -PrincipalId $client.ObjectId

En este ejemplo, a una entidad de servicio de cliente se le asigna un rol de aplicación (permiso de aplicación) definido por una entidad de servicio de recursos (por ejemplo, una API):

• ObjectId: ObjectId de la entidad de servicio de recursos (por ejemplo, una API).
• ResourceId: ObjectId de la entidad de servicio de recursos (por ejemplo, una API).
• Id: identificador del rol de aplicación (definido en la entidad de servicio de recursos) que se va a asignar a la entidad de servicio cliente. Si no se han definido roles de aplicación en la aplicación de recursos, puede usar 00000000-0000-0000-0000-000000000000.
• PrincipalId: ObjectId de la entidad de servicio de cliente a la que se asigna el rol de aplicación.

PS C:\> Connect-AzureAD
PS C:\> New-AzureADServiceAppRoleAssignment -ObjectId $resource.ObjectId -ResourceId $resource.ObjectId -Id $appRole.Id -PrincipalId $user.ObjectId

En este ejemplo, a un usuario se le asigna un rol de aplicación definido por una aplicación de recursos:

• ObjectId: ObjectId de la entidad de servicio de la aplicación.
• ResourceId: ObjectId de la entidad de servicio de la aplicación.
• Id: Identificador del rol de aplicación (definido en la entidad de servicio de la aplicación) que se va a asignar al usuario. Si no se ha definido ningún rol de aplicación para la aplicación de recursos, puede usarlo 00000000-0000-0000-0000-000000000000 para indicar que la aplicación está asignada al usuario.
• PrincipalId: ObjectId del usuario al que se asigna el rol de aplicación.

PS C:\> Connect-AzureAD
PS C:\> New-AzureADServiceAppRoleAssignment -ObjectId $resource.ObjectId -ResourceId $resource.ObjectId -Id $appRole.Id -PrincipalId $group.ObjectId

En este ejemplo, a un grupo se le asigna un rol de aplicación definido por una aplicación de recursos. Se considera que a todos los usuarios que son miembros directos del grupo asignado se les asigna el rol de aplicación:

• ObjectId: ObjectId de la entidad de servicio de la aplicación.
• ResourceId: ObjectId de la entidad de servicio de la aplicación.
• Id: Identificador del rol de aplicación (definido en la entidad de servicio de la aplicación) que se va a asignar al grupo. Si no se ha definido ningún rol de aplicación en la aplicación de recursos, puede usarlo 00000000-0000-0000-0000-000000000000 para indicar que la aplicación está asignada al grupo.
• PrincipalId: ObjectId del grupo al que se asigna el rol de aplicación.

PS C:\> Connect-AzureAD -TenantId $tenantOrDomain -ApplicationId $appId -CertificateThumbprint $thumb
PS C:\> New-AzureADServiceAppRoleAssignment -ObjectId $client.ObjectId -ResourceId $resource.ObjectId -Id $appRole.Id -PrincipalId $client.ObjectId

El comportamiento de este cmdlet cambia cuando se conecta al módulo de PowerShell de Azure AD mediante un registro de aplicación propiedad del cliente o una identidad de servicio, que incluye:

• Al conectarse como entidad de servicio, y
• Cuando se usa el AadAccessToken parámetro con un token de acceso obtenido para un registro de aplicación propiedad del cliente o una identidad de servicio.

En estas circunstancias, este cmdlet solo se usa para asignar un rol de aplicación a otra entidad de servicio, identificada por los ObjectId parámetros and PrincipalId :

• ObjectId: ObjectId de la entidad de servicio de cliente a la que se asigna el rol de aplicación.
• ResourceId: ObjectId de la entidad de servicio de recursos (por ejemplo, una API).
• Id: identificador del rol de aplicación (definido en la entidad de servicio de recursos) que se va a asignar a la entidad de servicio cliente. Si no se han definido roles de aplicación en la aplicación de recursos, puede usar 00000000-0000-0000-0000-000000000000.
• PrincipalId: ObjectId de la entidad de servicio de cliente a la que se asigna el rol de aplicación.

Cuando se conecta mediante una identidad de aplicación o servicio propiedad del cliente, use New-AzureADUserAppRoleAssignment y New-AzureADGroupAppRoleAssignment para crear asignaciones de roles de aplicación para un usuario y grupos, respectivamente.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Consulte la guía de migración de New-AzureADServiceAppRoleAssignment a Microsoft Graph PowerShell.