Get-FederationInformation
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.
Utilize o cmdlet Get-FederationInformation para obter informações de federação de uma organização externa do Exchange.
Dica
Para obter informações sobre as alterações efetuadas ao cmdlet Get-FederationInformation para melhorar a segurança e a privacidade, consulte Atualização Importante para o Cmdlet Get-FederationInformation no Exchange Online.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
Get-FederationInformation
-DomainName <SmtpDomain>
[-BypassAdditionalDomainValidation]
[-Force]
[-TrustedHostnames <MultiValuedProperty>]
[<CommonParameters>]
Description
O cmdlet Get-FederationInformation obtém informações de federação do domínio especificado, que deve ter a federação ativada.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Get-FederationInformation -DomainName contoso.com
Este exemplo obtém informações de federação do domínio contoso.com.
Parâmetros
-BypassAdditionalDomainValidation
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Proteção do Exchange Online
O comutador BypassAdditionalDomainValidation especifica que o comando ignora a validação de domínios da organização externa do Exchange. Não é preciso especificar um valor com essa opção.
Recomendamos que utilize apenas este comutador para obter informações de federação numa implementação híbrida entre organizações no local e Exchange Online. Não utilize este comutador para obter informações de federação para organizações do Exchange no local num acordo entre organizações.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-DomainName
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Proteção do Exchange Online
O parâmetro DomainName especifica o nome de domínio para o qual informações de federação serão recuperadas.
Propriedades do parâmetro
| Tipo: | SmtpDomain |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Proteção do Exchange Online
O comutador Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Um pedido de confirmação avisa-o se o nome do anfitrião no ponto final de Deteção Automática do domínio não corresponder ao certificado SSL (Secure Sockets Layer) apresentado pelo ponto final e o nome do anfitrião não for especificado no parâmetro TrustedHostnames.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-TrustedHostnames
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Proteção do Exchange Online
O parâmetro TrustedHostnames especifica o FQDN (nome de domínio totalmente qualificado) de pontos de extremidade de federação. Os pontos de extremidade de federação são os serviços de acesso (front-end) do cliente nos servidores de Caixa de Correio em uma organização com a federação habilitada. Especificar explicitamente o parâmetro TrustedHostnames permite que o cmdlet ignore a solicitação se o certificado apresentado pelo ponto de extremidade não corresponder ao nome de domínio especificado no parâmetro DomainName.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| 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 |
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, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.