Get-EntraContactMembership
Obtener una pertenencia de contacto.
Sintaxis
Default (valor predeterminado)
Get-EntraContactMembership
-OrgContactId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
Description
El Get-EntraContactMembership cmdlet obtiene una pertenencia a contactos en Microsoft Entra ID.
Este comando es útil para los administradores que necesitan comprender a qué grupos, roles o unidades administrativas pertenece un contacto determinado. Esto puede ser importante para solucionar problemas de acceso, auditar las pertenencias y asegurarse de que las pertenencias a contactos están configuradas correctamente.
En escenarios delegados con 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. Se pueden usar los siguientes roles con privilegios mínimos:
- Lectores de directorios
- Lector universal
- Escritores de directorios
- Administrador de Intune
- Administrador de usuarios
Ejemplos
Ejemplo 1: Obtener las pertenencias de un contacto
Connect-Entra -Scopes 'OrgContact.Read.All'
$contact = Get-EntraContact -Filter "displayName eq 'Contoso Contact'"
Get-EntraContactMembership -OrgContactId $contact.Id |
Select-Object Id, DisplayName, '@odata.type', SecurityEnabled | Format-Table -AutoSize
Id displayName @odata.type securityEnabled
-- ----------- ----------- ---------------
ffffffff-5555-6666-7777-aaaaaaaaaaaa All Employees #microsoft.graph.group False
Este comando obtiene todas las pertenencias para el contacto especificado.
Ejemplo 2: Obtener todas las pertenencias de un contacto
Connect-Entra -Scopes 'OrgContact.Read.All'
$contact = Get-EntraContact -Filter "displayName eq 'Contoso Contact'"
Get-EntraContactMembership -OrgContactId $contact.Id -All |
Select-Object Id, DisplayName, '@odata.type', SecurityEnabled | Format-Table -AutoSize
Id displayName @odata.type securityEnabled
-- ----------- ----------- ---------------
ffffffff-5555-6666-7777-aaaaaaaaaaaa All Employees #microsoft.graph.group False
Este comando obtiene todas las pertenencias para el contacto especificado.
Ejemplo 3: Obtener las dos principales pertenencias de un contacto
Connect-Entra -Scopes 'OrgContact.Read.All'
$contact = Get-EntraContact -Filter "displayName eq 'Contoso Contact'"
Get-EntraContactMembership -OrgContactId $contact.Id -Top 2 |
Select-Object Id, DisplayName, '@odata.type', SecurityEnabled | Format-Table -AutoSize
Id displayName @odata.type securityEnabled
-- ----------- ----------- ---------------
ffffffff-5555-6666-7777-aaaaaaaaaaaa All Employees #microsoft.graph.group False
Este comando obtiene las dos principales pertenencias para el contacto especificado. Puede usar -Limit como alias para -Top.
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.