Get-AzureADServicePrincipal
Obtiene una entidad de servicio.
Sintaxis
Get-AzureADServicePrincipal
[-All <Boolean>]
[-Top <Int32>]
[-Filter <String>]
[<CommonParameters>]
Get-AzureADServicePrincipal
[-SearchString <String>]
[-All <Boolean>]
[<CommonParameters>]
Get-AzureADServicePrincipal
-ObjectId <String>
[-All <Boolean>]
[<CommonParameters>]
Description
El cmdlet Get-AzureADServicePrincipal obtiene una entidad de servicio en Azure Active Directory (AD).
Ejemplos
Ejemplo 1: Recuperar todas las entidades de servicio del directorio
PS C:\> Get-AzureADServicePrincipal
ObjectId AppId DisplayName
-------- ----- -----------
00221b6f-4387-4f3f-aa85-34316ad7f956 e5e29b8a-85d9-41ea-b8d1-2162bd004528 Tenant Schema Extension App
012f6450-15be-4e45-b8b4-e630f0fb70fe 00000005-0000-0ff1-ce00-000000000000 Microsoft.YammerEnterprise
06ab01eb-3e77-4d14-ae31-322c7730a65b 09abbdfd-ed23-44ee-a2d9-a627aa1c90f3 ProjectWorkManagement
092aaf41-23e8-46eb-8c3d-fc0ee91cc62f 507bc9da-c4e2-40cb-96a7-ac90df92685c Office365Reports
0ac66e69-5502-4406-a294-6dedeadc8cab 2cf9eb86-36b5-49dc-86ae-9a63135dfa8c AzureTrafficManagerandDNS
0c0a6d9d-48c0-4aa7-b484-4e46f77d8ed9 0f698dd4-f011-4d23-a33e-b36416dcb1e6 Microsoft.OfficeClientService
0cbef08e-a4b5-4dd9-865e-8f521c1c5fb4 0469d4cd-df37-4d93-8a61-f8c75b809164 Microsoft Policy Administration Service
0ea80ff0-a9ea-43b6-b876-d5989efd8228 00000009-0000-0000-c000-000000000000 Microsoft Power BI Reporting and Analytics</dev:code>
Este comando recupera toda la entidad de servicio del directorio.
Ejemplo 2: Recuperación de una entidad de servicio por identificador
PS C:\> $ServicePrincipalId = (Get-AzureADServicePrincipal -Top 1).ObjectId
PS C:\> Get-AzureADServicePrincipal -ObjectId $ServicePrincipalId
ObjectId AppId DisplayName
-------- ----- -----------
00221b6f-4387-4f3f-aa85-34316ad7f956 e5e29b8a-85d9-41ea-b8d1-2162bd004528 Tenant Schema Extension App
El primer comando obtiene el identificador de una entidad de servicio mediante el cmdlet Get-AzureADServicePrincipal (./Get-AzureADServicePrincipal.md). El comando almacena el identificador en la variable $ServicePrincipalId.
El segundo comando obtiene la entidad de servicio identificada por $ServicePrincipalId.
Parámetros
-All
Si es true, devuelva todos los objetos serviceprincipal. Si es false, devuelva el número de objetos especificados por el parámetro Top.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Filter
Especifica una instrucción de filtro de oData v3.0. Este parámetro controla qué objetos se devuelven.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-ObjectId
Especifica el identificador de una entidad de servicio en Azure AD.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-SearchString
Especifica una cadena de búsqueda.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Top
Especifica el número máximo de registros que se van a devolver.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
Notas
Consulte la guía de migración de Get-AzureADServicePrincipal a Microsoft Graph PowerShell.