Compartir a través de

Get-AzADServicePrincipal

  • Referencia
Módulo:
Az.Resources

Filtra las entidades de servicio de Active Directory.

Sintaxis

Get-AzADServicePrincipal
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzADServicePrincipal
   -DisplayNameBeginsWith <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzADServicePrincipal
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzADServicePrincipal
   -ObjectId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzADServicePrincipal
   -ApplicationId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzADServicePrincipal
   -ApplicationObject <PSADApplication>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzADServicePrincipal
   -ServicePrincipalName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]

Description

Filtra las entidades de servicio de Active Directory.

Ejemplos

Ejemplo 1: Enumerar entidades de servicio de AD

PS C:\> Get-AzADServicePrincipal

Enumera todas las entidades de servicio de AD de un inquilino.

Ejemplo 2: Enumeración de entidades de servicio de AD mediante paginación

PS C:\> Get-AzADServicePrincipal -First 100

Enumera las 100 primeras entidades de servicio de AD de un inquilino.

Ejemplo 3: Enumeración de entidades de servicio por SPN

PS C:\> Get-AzADServicePrincipal -ServicePrincipalName 36f81fc3-b00f-48cd-8218-3879f51ff39f

Enumera las entidades de servicio con el SPN '36f81fc3-b00f-48cd-8218-3879f51ff39f'.

Ejemplo 4: Enumeración de entidades de servicio por cadena de búsqueda

PS C:\> Get-AzADServicePrincipal -SearchString "Web"

Enumera todas las entidades de servicio de AD cuyo nombre para mostrar comienza con "Web".

Ejemplo 5: Enumeración de entidades de servicio mediante canalización

PS C:\> Get-AzADApplication -ObjectId 39e64ec6-569b-4030-8e1c-c3c519a05d69 | Get-AzADServicePrincipal

Obtiene la aplicación de AD con el identificador de objeto '39e64ec6-569b-4030-8e1c-c3c519a05d69' y lo canaliza al cmdlet Get-AzADServicePrincipal para enumerar todas las entidades de servicio de esa aplicación.

Parámetros

-ApplicationId

Identificador de la aplicación de la entidad de servicio.

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

-ApplicationObject

Objeto de aplicación cuya entidad de servicio se está recuperando.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisplayName

Nombre para mostrar de la entidad de servicio.

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

-DisplayNameBeginsWith

Cadena de búsqueda de la entidad de servicio.

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

-First

Número máximo de objetos que se van a devolver.

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

-IncludeTotalCount

Informa del número de objetos del conjunto de datos. Actualmente, este parámetro no hace nada.

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

-ObjectId

Id. de objeto de la entidad de servicio.

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

-ServicePrincipalName

SPN del servicio.

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

-Skip

Omite los primeros objetos N y, a continuación, obtiene los objetos restantes.

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

Entradas

String

Guid

PSADApplication

Parámetros: ApplicationObject (ByValue)

Salidas

PSADServicePrincipal