Get-EntraExtensionProperty
Obtém propriedades de extensão registradas com Microsoft Entra ID.
Sintaxe
Default (Default)
Get-EntraExtensionProperty
[-IsSyncedFromOnPremises <Boolean>]
[-Name <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Get-EntraExtensionProperty obtém uma coleção que contém as propriedades de extensão registradas com Microsoft Entra ID por meio do Microsoft Entra ID Connect.
Você pode obter propriedades de extensão sincronizadas com Microsoft Entra ID locais que não são sincronizadas com Microsoft Entra ID locais ou ambos os tipos.
Esse comando retorna todas as definições de extensão de diretório registradas em um diretório, incluindo as de aplicativos multilocatários. As seguintes entidades suportam as propriedades da extensão:
- Usuário
- Group
- Unidade Administrativa
- Application
- Dispositivo
- Organização
Exemplos
Exemplo 1: obter propriedades de extensão sincronizadas de Microsoft Entra ID locais
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 {}
Esse comando obtém propriedades de extensão que têm sincronização de Microsoft Entra ID locais.
Exemplo 2: Obter propriedades de extensão usando o nome da extensão
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}
Esse comando recupera a extensão com base no nome da extensão (filtragem do lado do cliente).
Parâmetros
-IsSyncedFromOnPremises
Especifica se esse cmdlet obtém propriedades de extensão sincronizadas ou não sincronizadas.
-
$True– obtenha as propriedades de extensão sincronizadas do Microsoft Entra ID local. -
$False– obter propriedades de extensão que não são sincronizadas do Microsoft Entra ID local. -
No value– obter todas as propriedades de extensão (sincronizadas e não sincronizadas).
Propriedades do parâmetro
| Tipo: | System.Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Filtre usando o nome da extensão.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Default
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.