Get-EntraContactDirectReport

Módulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Obtenga los informes directos de un contacto.

Sintaxis

Default (valor predeterminado) 

Get-EntraContactDirectReport

    -OrgContactId <String>
    [-All]
    [-Top <Int32>]
    [-Property <String[]>]
    [<CommonParameters>]

Description

El Get-EntraContactDirectReport cmdlet obtiene los informes directos de un contacto.

Para escenarios delegados que implican cuentas profesionales o educativas, el usuario que ha iniciado sesión debe tener un rol de Microsoft Entra compatible o un rol personalizado con los permisos necesarios. Los siguientes roles con privilegios mínimos admiten esta operación:

  • Lectores de directorios: leer propiedades básicas
  • Lector universal
  • Escritores de directorios
  • Administrador de Intune
  • Administrador de usuarios

Ejemplos

Ejemplo 1: Obtener los informes directos de un contacto

Connect-Entra -Scopes 'OrgContact.Read.All'
$contact = Get-EntraContact -Filter "displayName eq 'Contoso Contact'"
Get-EntraContactDirectReport -OrgContactId $contact.Id

En este ejemplo se muestra cómo recuperar informes directos para un contacto organizativo.

Puede usar el comando Get-EntraBetaContact para obtener el contacto de la organización.

  • -OrgContactId el parámetro especifica el identificador de contacto.

Ejemplo 2: Obtener todos los informes directos de un contacto

Connect-Entra -Scopes 'OrgContact.Read.All'
$contact = Get-EntraContact -Filter "displayName eq 'Contoso Contact'"
Get-EntraContactDirectReport -OrgContactId $contact.Id -All

En este ejemplo se muestra cómo recuperar todos los informes directos de un contacto organizativo.

  • -OrgContactId el parámetro especifica el identificador de contacto.

Ejemplo 3: Obtener los dos principales informes directos de un contacto

Connect-Entra -Scopes 'OrgContact.Read.All'
$contact = Get-EntraContact -Filter "displayName eq 'Contoso Contact'"
Get-EntraContactDirectReport -OrgContactId $contact.Id -Top 2

En este ejemplo se muestra cómo recuperar los dos principales informes directos de un contacto organizativo. Puede usar -Limit como alias para -Top.

  • -OrgContactId el parámetro especifica el identificador de contacto.

Parámetros

-All

Enumera todas las páginas.

Propiedades de parámetro

Tipo:System.Management.Automation.SwitchParameter
Valor predeterminado:False
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

-OrgContactId

Especifica el identificador de un contacto en Microsoft Entra ID.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ObjectId (identificador de objeto)

Conjuntos de parámetros

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

-Property

Especifica las propiedades que se van a devolver.

Propiedades de parámetro

Tipo:

System.String[]

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

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

-Top

Especifica el número máximo de registros que se van a devolver.

Propiedades de parámetro

Tipo:System.Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Limit

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
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.