Get-MsolServicePrincipal

  • Referencia
Módulo:
MSOnline

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.