Get-ServicePrincipal

Módulo:

ExchangePowerShell

Se aplica a:

Exchange Online, Security & Compliance, Exchange Online Protection

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet Get-ServicePrincipal para ver información sobre las entidades de servicio de la organización basada en la nube.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Get-ServicePrincipal
   [[-Identity] <ServicePrincipalIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [<CommonParameters>]

Description

Las entidades de servicio existen en Azure Active Directory para definir qué pueden hacer las aplicaciones, quién puede acceder a ellas y a qué recursos pueden acceder las aplicaciones. En Exchange Online, las entidades de servicio son referencias a las entidades de servicio de Azure AD. Para asignar Exchange Online roles de control de acceso basado en rol (RBAC) a las entidades de servicio de Azure AD, use las referencias de entidad de servicio en Exchange Online. Los cmdlets *-ServicePrincipal de Exchange Online PowerShell permiten ver, crear y quitar estas referencias de entidad de servicio.

Para más información, consulte Objetos de aplicación y entidad de servicio en Azure Active Directory.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Get-ServicePrincipal

En este ejemplo se devuelve una lista de resumen de todas las entidades de servicio.

Ejemplo 2

Get-ServicePrincipal -Identity ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 | Format-List

En este ejemplo se devuelve información detallada sobre la entidad de servicio con el valor de ServiceId ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1.

Parámetros

-Identity

El parámetro Identity especifica la entidad de servicio que desea ver. Puede usar cualquier valor que identifique de forma única la entidad de servicio. Por ejemplo:

• Nombre
• Nombre completo (DN)
• GUID
• Appid
• ServiceId

Type:	ServicePrincipalIdParameter
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protectionn

-Organization

Este parámetro está reservado para uso interno de Microsoft.

Type:	OrganizationIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection