Compartir a través de

Get-AzADServicePrincipal

Módulo:
Az.Resources Module

Enumera las entidades de las entidades de servicio o obtiene la entidad de las entidades de servicio por clave.

Sintaxis

EmptyParameterSet (valor predeterminado) 

Get-AzADServicePrincipal
    [-Select <String[]>]
    [-Count]
    [-Filter <String>]
    [-Orderby <String[]>]
    [-Search <String>]
    [-ConsistencyLevel <String>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [-CountVariable <String>]
    [<CommonParameters>]

ObjectIdParameterSet 

Get-AzADServicePrincipal
    -ObjectId <String>
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

SearchStringParameterSet 

Get-AzADServicePrincipal
    -DisplayNameBeginsWith <String>
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

DisplayNameParameterSet 

Get-AzADServicePrincipal
    -DisplayName <String>
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ApplicationIdParameterSet 

Get-AzADServicePrincipal
    -ApplicationId <Guid>
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ApplicationObjectParameterSet 

Get-AzADServicePrincipal
    -ApplicationObject <IMicrosoftGraphApplication>
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

SPNParameterSet 

Get-AzADServicePrincipal
    -ServicePrincipalName <String>
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Description

Enumera las entidades de las entidades de servicio o obtiene la entidad de las entidades de servicio por clave.

Ejemplos

Ejemplo 1: Obtención de la entidad de servicio por nombre para mostrar

Get-AzADServicePrincipal -DisplayName $name

Obtención de la entidad de servicio por nombre para mostrar

Ejemplo 2: La búsqueda del nombre para mostrar de la entidad de servicio comienza por

Get-AzADServicePrincipal -DisplayNameStartsWith $prefix

La búsqueda del nombre para mostrar de la entidad de servicio comienza por

Ejemplo 3: Enumerar entidades de servicio

Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected

Enumere las primeras 10 entidades de servicio y anexe la propiedad 'Tags' después de las propiedades predeterminadas: 'DisplayName', 'Id', 'DeletedDateTime', 'ServicePrincipalNames', 'AppId'

Ejemplo 4: Obtención de la entidad de servicio por identificador de aplicación

Get-AzADServicePrincipal -ApplicationId $appId

Obtención de la entidad de servicio por identificador de aplicación

Ejemplo 5: Obtención de la entidad de servicio por entrada de canalización

Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal

Obtención de la entidad de servicio por entrada de canalización

Ejemplo 6: Obtención de la entidad de servicio con filtro

Get-AzADServicePrincipal -Filter "startsWith(DisplayName,'some-name')"

Obtención de la entidad de servicio con filtro

Ejemplo 7: Asignación de OdataCount a una variable

Get-AzADServicePrincipal -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

Asignación de OdataCount a una variable

Parámetros

-AppendSelected

Anexar propiedades seleccionadas con propiedades predeterminadas cuando este modificador está activado, solo funciona con el parámetro "-Select".

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ApplicationId

id. de aplicación de serviceprincipal

Propiedades de parámetro

Tipo:Guid
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AppId

Conjuntos de parámetros

ApplicationIdParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ApplicationObject

El objeto de entidad de servicio, podría usarse como entrada de canalización.

Propiedades de parámetro

Tipo:IMicrosoftGraphApplication
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ApplicationObjectParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ConsistencyLevel

Indica el nivel de coherencia solicitado. Dirección URL de documentación: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

EmptyParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Count

Incluir recuento de elementos

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

EmptyParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CountVariable

Especifica un recuento del número total de elementos de una colección. De forma predeterminada, esta variable se establecerá en el ámbito global.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

EmptyParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:PSObject
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DisplayName

serviceprincipal display name (nombre para mostrar de serviceprincipal)

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DisplayNameParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DisplayNameBeginsWith

serviceprincipal display name starts with (nombre para mostrar de serviceprincipal) comienza por

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:DisplayNameStartsWith, SearchString

Conjuntos de parámetros

SearchStringParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Filter

Filtre los elementos por valores de propiedad para obtener más detalles sobre la consulta de filtro, consulte: https://dori-uw-1.kuma-moon.com/en-us/graph/filter-query-parameter

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

EmptyParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-First

Obtiene solo los primeros objetos 'n'.

Propiedades de parámetro

Tipo:UInt64
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ObjectId

key: identificador de servicePrincipal

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:IdentificadorPrincipalDeServicio, Id

Conjuntos de parámetros

ObjectIdParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Orderby

Ordenar elementos por valores de propiedad

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

EmptyParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Search

Buscar elementos por frases de búsqueda

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

EmptyParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Select

Selección de propiedades que se van a devolver

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServicePrincipalName

nombre de serviceprincipal

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:SPN

Conjuntos de parámetros

SPNParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Skip

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

Propiedades de parámetro

Tipo:UInt64
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

IMicrosoftGraphApplication

Salidas

IMicrosoftGraphServicePrincipal