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