Get-MsolServicePrincipal
Obtiene entidades de servicio de Azure Active Directory.
Syntax
Get-MsolServicePrincipal
[-SearchString <String>]
[-MaxResults <Int32>]
[-TenantId <Guid>]
[<CommonParameters>]
Get-MsolServicePrincipal
-ObjectId <Guid>
[-TenantId <Guid>]
[<CommonParameters>]
Get-MsolServicePrincipal
-AppPrincipalId <Guid>
[-TenantId <Guid>]
[<CommonParameters>]
Get-MsolServicePrincipal
-ServicePrincipalName <String>
[-TenantId <Guid>]
[<CommonParameters>]
Get-MsolServicePrincipal
[-SearchString <String>]
[-All]
[-TenantId <Guid>]
[<CommonParameters>]
Description
El cmdlet Get-MsolServicePrincipal obtiene una entidad de servicio o una lista de entidades de servicio de Azure Active Directory.
Ejemplos
Ejemplo 1: Mostrar todas las entidades de servicio
PS C:\> Get-MsolServicePrincipal
Este comando muestra todas las entidades de servicio existentes en el inquilino de la organización.
Ejemplo 2: Obtención de entidades de servicio mediante un nombre
PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"
Este comando obtiene todas las entidades de servicio existentes que tienen un nombre de entidad de servicio que comienza por MyApp. Se trata de una coincidencia exacta de la parte appClass del nombre de la entidad de seguridad de servicio hasta la barra diagonal.
Ejemplo 3: Obtención de una entidad de servicio
PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b
Este comando obtiene una entidad de servicio que tiene un identificador de entidad de seguridad de aplicación específico.
Parámetros
-All
Indica que este cmdlet devuelve todos los resultados. No especifique junto con el parámetro MaxResults .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AppPrincipalId
Especifica el identificador de aplicación único de la entidad de servicio que se va a obtener.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MaxResults
Especifica el número máximo de resultados que devuelve este cmdlet. El valor predeterminado es 500.
Type: | Int32 |
Position: | Named |
Default value: | 500 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
Especifica el identificador de objeto único de la entidad de servicio que se va a obtener.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SearchString
Especifica una cadena para que coincida con los nombres de entidad de seguridad de servicio.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServicePrincipalName
Especifica el nombre de la entidad de servicio o las entidades de servicio que se van a obtener. Un SPN debe usar uno de los siguientes formatos:
appName
appName/hostname
- una dirección URL válida
AppName representa el nombre de la aplicación y el nombre de host representa la entidad de URI de la aplicación.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TenantId
Especifica el identificador único del inquilino en el que se va a realizar la operación. El valor predeterminado es el inquilino del usuario actual. Este parámetro solo se aplica a los usuarios asociados.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Salidas
Microsoft.Online.Administration.ServicePrincipal[]
Este cmdlet devuelve una entidad de servicio o una lista de entidades de servicio de Azure Active Directory. Cada entidad de servicio contiene la información siguiente:
- Idobjeto. Identificador único de la entidad de servicio.
- AppPrincipalId. Identificador de aplicación de la entidad de servicio.
- Displayname. Nombre descriptivo de la entidad de servicio.
- ServicePrincipalName. Lista de nombres de entidad de seguridad de servicio (SPN) asociados a la entidad de servicio.
- AccountEnabled. Valor que indica si la cuenta está habilitada.
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de