Get-AzADServicePrincipal

Referencia

Módulo:: Az.Resources

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

Sintaxis

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

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

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

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

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

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

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ServicePrincipalName <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".

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

-ApplicationId

id. de aplicación de serviceprincipal

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

-ApplicationObject

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

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

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

-Count

Incluir recuento de elementos

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
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:	PSObject
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisplayName

serviceprincipal display name (nombre para mostrar de serviceprincipal)

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

-DisplayNameBeginsWith

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

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

-Filter

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

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

-First

Obtiene solo los primeros objetos 'n'.

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

-ObjectId

key: identificador de servicePrincipal

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

-Orderby

Ordenar elementos por valores de propiedad

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

-Search

Buscar elementos por frases de búsqueda

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

-Select

Selección de propiedades que se van a devolver

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

-ServicePrincipalName

nombre de serviceprincipal

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

IMicrosoftGraphApplication

Salidas

IMicrosoftGraphServicePrincipal

Compartir a través de