Get-FederationInformation

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ambiente ou de outro.

Use 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 feitas no cmdlet do 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 (Default)

Get-FederationInformation
    -DomainName <SmtpDomain>
    [-BypassAdditionalDomainValidation]
    [-Force]
    [-TrustedHostnames <MultiValuedProperty>]
    [<CommonParameters>]

Description

O cmdlet Get-FederationInformation recupera informações de federação do domínio especificado, que deve ter a federação habilitada.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. 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, Complemento de segurança interna para segurança local caixas de correio

A opção BypassAdditionalDomainValidation especifica que o comando ignore a validação de domínios da organização externa do Exchange. Não é preciso especificar um valor com essa opção.

Recomendamos que você use essa opção apenas para recuperar informações de federação em uma implantação híbrida entre as organizações locais e do Exchange Online. Não use essa opção para recuperar informações de federação para organizações locais do Exchange em um 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, Complemento de segurança interna para segurança local caixas de correio

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, Complemento de segurança interna para segurança local caixas de correio

A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Um prompt de confirmação avisa se o nome do host no ponto de extremidade de Descoberta Automática do domínio não corresponder ao certificado TLS (Transport Layer Security) apresentado pelo ponto de extremidade e o nome do host não estiver 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, Complemento de segurança interna para segurança local caixas de correio

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 dá suporte aos 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.