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.