Compartir a través de

Get-AzureRmADServicePrincipal

  • Referencia
Módulo:
AzureRM.Resources

Filtra las entidades de servicio de Active Directory.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Get-AzureRmADServicePrincipal
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayNameBeginsWith <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ObjectId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationObject <PSADApplication>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -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-AzureRmADServicePrincipal

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-AzureRmADServicePrincipal -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-AzureRmADServicePrincipal -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-AzureRmADServicePrincipal -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-AzureRmADApplication -ObjectId 39e64ec6-569b-4030-8e1c-c3c519a05d69 | Get-AzureRmADServicePrincipal

Obtiene la aplicación de AD con el identificador de objeto '39e64ec6-569b-4030-8e1c-c3c519a05d69' y lo canaliza al cmdlet Get-AzureRmADServicePrincipal 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:AzureRmContext, 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