Get-EntraExtensionProperty
Obtiene las propiedades de extensión registradas con Microsoft Entra ID.
Sintaxis
Default (valor predeterminado)
Get-EntraExtensionProperty
[-IsSyncedFromOnPremises <Boolean>]
[-Name <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Get-EntraExtensionProperty obtiene una colección que contiene las propiedades de extensión registradas con Microsoft Entra ID a través de Microsoft Entra ID Connect.
Puede obtener propiedades de extensión sincronizadas con Microsoft Entra ID locales que no están sincronizadas con Microsoft Entra ID locales o con ambos tipos.
Este comando devuelve todas las definiciones de extensión de directorio registradas en un directorio, incluidas las de aplicaciones multiinquilino. Las siguientes entidades admiten propiedades de extensión:
- User
- Group
- Unidad Administrativa
- Application
- Dispositivo
- Organization
Ejemplos
Ejemplo 1: Obtención de propiedades de extensión sincronizadas desde Microsoft Entra ID locales
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraExtensionProperty -IsSyncedFromOnPremises $True
Id AppDisplayName DataType IsMultiValued IsSyncedFromOnPremises Name TargetObjects
-- -------------- -------- ------------- ---------------------- ---- -------------
bd647a28-ae50-4e03-a915-067da7ff6cec Contoso App String False False extension_12345_JobGroup {User}
daa3b0e4-b14c-40a4-bb91-a2c017ac2b28 Contoso App String False False extension_12345_CostCenter {User}
4113c724-f8c3-4fdf-ac5b-b1cf1440ff55 Contoso App String False False extension_12345_EmploymentNumber {}
Este comando obtiene propiedades de extensión que tienen sincronización desde Microsoft Entra ID locales.
Ejemplo 2: Obtener propiedades de extensión mediante el nombre de la extensión
Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraExtensionProperty -IsSyncedFromOnPremises $False -Name extension_12345_JobGroup
Id AppDisplayName DataType IsMultiValued IsSyncedFromOnPremises Name TargetObjects
-- -------------- -------- ------------- ---------------------- ---- -------------
bd647a28-ae50-4e03-a915-067da7ff6cec Contoso App String False False extension_12345_JobGroup {User}
Este comando recupera la extensión en función del nombre de la extensión (filtrado del lado cliente).
Parámetros
-IsSyncedFromOnPremises
Especifica si este cmdlet obtiene propiedades de extensión que se sincronizan o no.
-
$True: obtiene las propiedades de extensión que se sincronizan desde el Microsoft Entra ID local. -
$False: obtiene las propiedades de extensión que no se sincronizan desde el Microsoft Entra ID local. -
No value: obtiene todas las propiedades de extensión (sincronizadas y no asincrónicas).
Propiedades de parámetro
| Tipo: | System.Boolean |
| 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 |
-Name
Filtre mediante el nombre de la extensión.
Propiedades de parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Default
| 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 |
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.