Compartilhar via


Set-OrganizationRelationship

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 Set-OrganizationRelationship para modificar as relações existentes da organização. As relações de organização definem as configurações usadas com organizações externas do Exchange para acessar informações gratuitas/ocupadas do calendário ou para mover caixas de correio entre servidores locais do Exchange e Exchange Online como parte de implantações híbridas.

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

Syntax

Set-OrganizationRelationship
   [-Identity] <OrganizationRelationshipIdParameter>
   [-ArchiveAccessEnabled <Boolean>]
   [-Confirm]
   [-DeliveryReportEnabled <Boolean>]
   [-DomainController <Fqdn>]
   [-DomainNames <MultiValuedProperty>]
   [-Enabled <Boolean>]
   [-Force]
   [-FreeBusyAccessEnabled <Boolean>]
   [-FreeBusyAccessLevel <FreeBusyAccessLevel>]
   [-FreeBusyAccessScope <GroupIdParameter>]
   [-MailboxMoveCapability <MailboxMoveCapability>]
   [-MailboxMoveEnabled <Boolean>]
   [-MailboxMovePublishedScopes <MultiValuedProperty>]
   [-MailTipsAccessEnabled <Boolean>]
   [-MailTipsAccessLevel <MailTipsAccessLevel>]
   [-MailTipsAccessScope <GroupIdParameter>]
   [-Name <String>]
   [-OAuthApplicationId <String>]
   [-OrganizationContact <SmtpAddress>]
   [-PhotosEnabled <Boolean>]
   [-TargetApplicationUri <Uri>]
   [-TargetAutodiscoverEpr <Uri>]
   [-TargetOwaURL <Uri>]
   [-TargetSharingEpr <Uri>]
   [-WhatIf]
   [<CommonParameters>]

Description

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

Set-OrganizationRelationship -Identity "Fourth Coffee" -FreeBusyAccessLevel LimitedDetails

Este exemplo modifica o nível de acesso às informações de disponibilidade para LimitedDetails, o que inclui a hora, o assunto e o local.

Exemplo 2

Set-OrganizationRelationship -Identity "Contoso" -Enabled $false

Este exemplo desabilita o relacionamento da organização com Contoso

Parâmetros

-ArchiveAccessEnabled

O parâmetro ArchiveAccessEnabled especifica se o relacionamento da organização foi configurado para fornecer acesso de arquivo remoto. Os valores válidos são:

  • $true: a organização externa fornece acesso remoto aos arquivos da caixa de correio.
  • $false: a organização externa não fornece acesso remoto aos arquivos da caixa de correio. Este é o valor padrão
Type:Boolean
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

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
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

-DeliveryReportEnabled

O parâmetro DeliveryReportEnabled especifica se os Relatórios de Entrega devem ser compartilhados sobre a relação da organização. Os valores válidos são:

  • $true: relatórios de entrega devem ser compartilhados sobre a relação da organização. Esse valor significa que a organização concordou em compartilhar todos os Relatórios de Entrega com a organização externa e a relação da organização deve ser usada para recuperar informações do Relatório de Entrega da organização externa.
  • $false: os Relatórios de Entrega não devem ser compartilhados sobre a relação da organização. Este é o valor padrão

Para que o rastreamento de mensagens funcione em um cenário do Exchange entre locais, esse parâmetro deve ser definido como $true em ambos os lados da relação de organização. Se o valor desse parâmetro for definido como $false em um ou em ambos os lados da relação de organização, o rastreamento de mensagens entre as organizações não funcionará em nenhuma das direções.

Type:Boolean
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

-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
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

-DomainNames

O parâmetro DomainNames especifica os domínios SMTP da organização externa. Você pode especificar vários domínios separados por vírgulas (por exemplo, "contoso.com", "northamerica.contoso.com").

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

-Enabled

O parâmetro Enabled especifica se o relacionamento da organização deve ser habilitado. Os valores válidos são:

  • $true: a relação de organização está habilitada. Esse é o valor padrão.
  • $false: a relação de organização está desabilitada. Esse valor interrompe completamente o compartilhamento para a relação de organização.
Type:Boolean
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

-Force

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

Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.

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

-FreeBusyAccessEnabled

O parâmetro FreeBusyAccessEnabled especifica se a relação de organização deve ser usada para recuperar informações gratuitas/ocupadas da organização externa. Os valores válidos são:

  • $true: informações gratuitas/ocupadas são recuperadas da organização externa.
  • $false: informações gratuitas/ocupadas não são recuperadas da organização externa. Esse é o valor padrão.

Você controla o nível e o escopo de acesso livre/ocupado usando os parâmetros FreeBusyAccessLevel e FreeBusyAccessScope.

Type:Boolean
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

-FreeBusyAccessLevel

O parâmetro FreeBusyAccessLevel especifica a quantidade máxima de detalhes retornados para a organização solicitante. Os valores válidos são:

  • Nenhum: sem acesso livre/ocupado.
  • DisponibilidadeOnly: acesso gratuito/ocupado somente com tempo.
  • LimitedDetails: acesso gratuito/ocupado com tempo, assunto e localização.

Esse parâmetro só é significativo quando o valor do parâmetro FreeBusyAccessEnabled é $true.

Type:FreeBusyAccessLevel
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

-FreeBusyAccessScope

O parâmetro FreeBusyAccessScope especifica um grupo de segurança habilitado para email na organização interna que contém usuários cujas informações gratuitas/ocupadas são acessíveis por uma organização externa. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • Nome diferenciado (DN)
  • GUID

Esse parâmetro só é significativo quando o valor do parâmetro FreeBusyAccessEnabled é $true.

Type:GroupIdParameter
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

-Identity

O parâmetro Identity especifica a relação de organização que você deseja modificar. Você pode usar qualquer valor que identifique exclusivamente a relação de organização. Por exemplo:

  • Nome
  • Nome canônico
  • GUID
Type:OrganizationRelationshipIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MailboxMoveCapability

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro MailboxMoveCapability é usado em migrações de caixa de correio entre locatários. Os valores válidos são:

  • Entrada
  • Saída
  • RemoteInbound
  • RemoteOutbound

Para obter mais informações, confira Migração de caixa de correio entre locatários.

Type:MailboxMoveCapability
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MailboxMoveEnabled

O parâmetro MailboxMoveEnabled especifica se a relação da organização permite mover caixas de correio para ou da organização externa. Os valores válidos são:

  • $true: a caixa de correio é permitida para ou para a organização externa.
  • $false: a caixa de correio para a qual a organização externa é movida não é permitida. Esse é o valor padrão.
Type:Boolean
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

-MailboxMovePublishedScopes

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro MailboxMovePublishedScopes é usado em migrações entre locatários para especificar os grupos de segurança habilitados para email cujos membros podem migrar. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • Nome diferenciado (DN)
  • GUID

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Para obter mais informações, confira Migração de caixa de correio entre locatários.

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

-MailTipsAccessEnabled

O parâmetro MailTipsAccessEnabled especifica se o MailTips para usuários dessa organização é retornado sobre essa relação de organização. Os valores válidos são:

  • $true: As Dicas de Email para usuários nesta organização são retornadas por meio do relacionamento com a organização.
  • $false: As Dicas de Email para usuários desta organização não são retornadas por meio do relacionamento com a organização. Esse é o valor padrão.

Você controla o nível de acesso do MailTips usando o parâmetro MailTipsAccessLevel.

Type:Boolean
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

-MailTipsAccessLevel

O parâmetro MailTipsAccessLevel especifica o nível dos dados do Dicas de Email compartilhados externamente na relação desta organização. Este parâmetro pode ter os seguintes valores:

  • Todos: Todas as Dicas de Email são retornadas, mas os destinatários da organização remota são considerados externos. Para a Dica de Email de Resposta Automática, a mensagem de Resposta Automática externa é retornada.
  • Limitado: somente os MailTips que poderiam impedir um NDR (relatório de não entrega) ou uma Resposta Automática são retornados. Dicas de Email personalizadas, a Dica de Email de Grande Público e Dicas de Email de Destinatário Moderado não serão retornadas.
  • Nenhum: nenhuma MailTips é retornada à organização remota. Esse é o valor padrão.

Esse parâmetro só é significativo quando o valor do parâmetro MailTipsAccessEnabled é $true.

Type:MailTipsAccessLevel
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

-MailTipsAccessScope

O parâmetro MailTipsAccessScope especifica um grupo de segurança habilitado para email na organização interna que contém usuários cujas informações gratuitas/ocupadas são acessíveis por uma organização externa. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • Nome diferenciado (DN)
  • GUID

O valor padrão está em branco ($null), o que significa que nenhum grupo é especificado.

Se você usar esse parâmetro, os MailTips específicos do destinatário serão retornados somente para os destinatários que são membros do grupo especificado. Dicas de Email específicas para destinatários são:

  • Resposta Automática
  • Caixa de Correio Cheia
  • Personalizado

Se você não usar esse parâmetro, as MailTips específicas do destinatário serão retornadas para todos os destinatários da organização.

Esta restrição se aplica somente a caixas de correio, usuários de email e contatos de email. Não se aplica aos grupos de distribuição.

Type:GroupIdParameter
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

-Name

O parâmetro Nome especifica o nome exclusivo da relação de organização. O tamanho máximo é de 64 caracteres.

Type:String
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

-OAuthApplicationId

Esse parâmetro só está disponível no serviço baseado em nuvem.

O OAuthApplicationId é usado em migrações de caixa de correio entre locatários para especificar a ID do aplicativo de migração de caixa de correio ao qual você consentiu. Para obter mais informações, confira Migração de caixa de correio entre locatários.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-OrganizationContact

O parâmetro OrganizationContact especifica o endereço de email que pode ser usado para contatar a organização externa (por exemplo, administrator@fourthcoffee.com).

Type:SmtpAddress
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

-PhotosEnabled

O parâmetro PhotosEnabled especifica se as fotos para usuários na organização interna são retornadas sobre a relação da organização. Os valores válidos são:

  • $true: As fotos para usuários dessa organização são retornadas sobre a relação da organização.
  • $false: as fotos para usuários dessa organização não são retornadas por meio do relacionamento com a organização. Esse é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TargetApplicationUri

O parâmetro TargetApplicationUri especifica o (URI) da organização externa. O parâmetro TargetApplicationUri é especificado pelo Exchange ao solicitar um token delegado para recuperar informações gratuitas e ocupadas, por exemplo, mail.contoso.com.

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

-TargetAutodiscoverEpr

O parâmetro TargetAutodiscoverEpr especifica a URL de Descoberta Automática dos Serviços Web do Exchange para a organização externa, por exemplo, https://contoso.com/autodiscover/autodiscover.svc/wssecurity. O Exchange usa o Autodiscover para detectar automaticamente o ponto de extremidade correto do servidor exchange a ser usado para solicitações externas.

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

-TargetOwaURL

O parâmetro TargetOwaURL especifica a URL Outlook na Web (anteriormente Outlook Web App) da organização externa definida na relação de organização. Ele é usado para Outlook na Web redirecionamento em um cenário de Exchange entre instalações. A configuração desse atributo permite que os usuários da organização usem sua URL de Outlook na Web atual para acessar Outlook na Web na organização externa.

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

-TargetSharingEpr

O parâmetro TargetSharingEpr especifica a URL dos Serviços Web do Exchange de destino para a organização externa.

Se você usar esse parâmetro, essa URL sempre será usada para alcançar o servidor externo do Exchange. O THEURL especificado pelo parâmetro TargetAutoDiscoverEpr não é usado para localizar o servidor externo do Exchange.

Type:Uri
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

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
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.