Get-ServicePrincipal
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.
Sintaxis
Default (valor predeterminado)
Get-ServicePrincipal
[[-Identity] <ServicePrincipalIdParameter>]
[-Organization <OrganizationIdParameter>]
[<CommonParameters>]
Description
Las entidades de servicio existen en Microsoft Entra ID para definir qué pueden hacer las aplicaciones, quién puede acceder a las aplicaciones y a qué recursos pueden acceder las aplicaciones. En Exchange Online, las entidades de servicio son referencias a las entidades de servicio de Microsoft Entra ID. Para asignar Exchange Online roles de control de acceso basado en rol (RBAC) a las entidades de servicio de Microsoft Entra ID, 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 obtener más información, consulte Objetos de aplicación y entidad de servicio en Microsoft Entra ID.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. 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 de una organización.
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 objectId ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1.
Parámetros
-Identity
Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales
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
- ObjectId
Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores del parámetro Identity son precisas y no contienen valores $null inexistentes.
Propiedades de parámetro
| Tipo: | ServicePrincipalIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Organization
Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | OrganizationIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.