Get-FederationInformation

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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 ou outro ambiente.

Use o cmdlet Get-FederationInformation para obter informações de federação, incluindo nomes de domínio federados e URLs de destino, de uma organização externa do Exchange.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

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

Description

O cmdlet Get-FederationInformation recupera informações de federação do domínio especificado. Os resultados do cmdlet podem ser canalizados para o cmdlet New-OrganizationRelationship para estabelecer uma relação de organização com a organização exchange que está sendo consultada.

O domínio especificado deve ter a federação habilitada.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico 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

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 você use apenas essa opção para recuperar informações de federação em uma implantação híbrida entre organizações locais e Exchange Online. Não use essa opção para recuperar informações de federação para organizações locais do Exchange em um arranjo entre organizações.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainName

O parâmetro DomainName especifica o nome de domínio para o qual informações de federação serão recuperadas.

Type:	SmtpDomain
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Force

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 Autodiscover do domínio não corresponder ao certificado SSL (Secure Sockets Layer) apresentado pelo ponto de extremidade e o nome do host não for especificado no parâmetro TrustedHostnames.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TrustedHostnames

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.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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.