Get-EntraExtensionProperty

Regista propriedades de extensão com o Microsoft Entra ID.

Sintaxe

Default (Predefinição)

Get-EntraExtensionProperty

    [-IsSyncedFromOnPremises <Boolean>]
    [-Name <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrição

O cmdlet Get-EntraExtensionProperty recebe uma coleção que contém as propriedades de extensão registadas com Microsoft Entra ID através do Microsoft Entra ID Connect.

Podes obter propriedades de extensão sincronizadas com o Microsoft Entra ID local que não estão sincronizadas com o Microsoft Entra ID local ou com ambos os tipos.

Este comando devolve todas as definições de extensões de diretório registadas num diretório, incluindo as de aplicações multiinquilino. As seguintes entidades suportam propriedades de extensão:

  • Utilizador
  • Group
  • Unidade Administrativa
  • Application
  • Dispositivo
  • Organization

Exemplos

Exemplo 1: Sincronizar propriedades de extensão a partir do Microsoft Entra ID local

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 obtém propriedades de extensão que têm sincronização do Microsoft Entra ID local.

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}

Este comando recupera a extensão com base no nome da extensão (filtragem do lado do cliente).

Parâmetros

-IsSyncedFromOnPremises

Especifica se este cmdlet recebe propriedades de extensão que estão sincronizadas ou não.

  • $True- obter propriedades de extensão sincronizadas a partir do Microsoft Entra ID local.
  • $False- obter propriedades de extensão que não são sincronizadas a partir do Microsoft Entra ID local.
  • No value - obter todas as propriedades da extensão (sincronizadas e não sincronizadas).

Propriedades dos parâmetros

Tipo:System.Boolean
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Filtre usando o nome da extensão.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Default
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.