Get-EntraIdentityProvider

Esse cmdlet é usado para recuperar os provedores de identidade configurados no diretório.

Sintaxe

GetQuery (Default)

Get-EntraIdentityProvider

    [-Property <String[]>]
    [<CommonParameters>]

GetById

Get-EntraIdentityProvider

    -IdentityProviderBaseId <String>
    [-Property <String[]>]
    [<CommonParameters>]

Description

O Get-EntraIdentityProvider cmdlet é usado para recuperar os provedores de identidade que foram configurados no diretório. Esses provedores de identidade podem ser usados para permitir que os usuários se inscrevam ou entrem em aplicativos protegidos por Azure AD B2C.

Configurar um provedor de identidade em seu locatário Microsoft Entra também permite cenários de convidado B2B futuros. Por exemplo, uma organização tem recursos em Microsoft 365 que precisam ser compartilhados com um usuário do Gmail. O usuário do Gmail usará suas credenciais de conta do Google para autenticar e acessar os documentos.

O conjunto atual de provedores de identidade pode ser Microsoft, Google, Facebook, Amazon ou LinkedIn.

Em cenários delegados usando contas corporativas ou de estudante, o usuário conectado deve ter uma função Microsoft Entra ou uma função personalizada com as permissões necessárias. As seguintes funções com privilégios mínimos dão suporte a esta operação:

  • Administrador do Fornecedor de Identidade Externo

Exemplos

Exemplo 1: recuperar todos os provedores de identidade

Connect-Entra -Scopes 'IdentityProvider.Read.All'
Get-EntraIdentityProvider
Id                   DisplayName
--                   -----------
AADSignup-OAUTH      Directory Sign up
Google-OAUTH         Test
EmailOtpSignup-OAUTH Email One Time Passcode
MSASignup-OAUTH      Microsoft Account

Este exemplo recupera a lista de todos os provedores de identidade configurados e suas propriedades.

Exemplo 2: recuperar o provedor de identidade por Id

Connect-Entra -Scopes 'IdentityProvider.Read.All'
Get-EntraIdentityProvider -IdentityProviderBaseId Google-OAUTH
Id           DisplayName
--           -----------
Google-OAUTH GoogleName

Este exemplo recupera as propriedades do provedor de identidade especificado.

  • -IdentityProviderBaseId O parâmetro especifica o identificador exclusivo do provedor de identidade.

Parâmetros

-IdentityProviderBaseId

O identificador exclusivo para um provedor de identidade.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ID

Conjuntos de parâmetros

GetById
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Property

Especifica as propriedades a serem retornadas.

Propriedades do parâmetro

Tipo:

System.String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Select

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

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.

Entradas

System.String

Saídas

System.Object