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.
-
-IdentityProviderBaseIdO 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.