Get-MsolServicePrincipal

  • Referencia
Módulo:
MSOnline

Obtiene entidades de servicio de Azure Active Directory.

Sintaxis

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 .

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AppPrincipalId

Especifica el identificador de aplicación único de la entidad de servicio que se va a obtener.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-MaxResults

Especifica el número máximo de resultados que devuelve este cmdlet. El valor predeterminado es 500.

Tipo:Int32
Posición:Named
Valor predeterminado:500
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ObjectId

Especifica el identificador de objeto único de la entidad de servicio que se va a obtener.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SearchString

Especifica una cadena para que coincida con los nombres de entidad de seguridad de servicio.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.