Add-AvailabilityAddressSpace

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 Add-AvailabilityAddressSpace para criar objetos de espaço de endereço de disponibilidade usados para compartilhar dados gratuitos/ocupados entre organizações do Exchange.

O número máximo de espaços de endereço de disponibilidade retornados pelo Active Directory ao Exchange é 100. É recomendável usar 100 ou menos espaços de endereço para que pesquisas de disponibilidade funcionem corretamente.

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

Syntax

Add-AvailabilityAddressSpace
   -AccessMethod <AvailabilityAccessMethod>
   -ForestName <String>
   [-Confirm]
   [-Credentials <PSCredential>]
   [-DomainController <Fqdn>]
   [-ProxyUrl <Uri>]
   [-TargetAutodiscoverEpr <Uri>]
   [-UseServiceAccount <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

Em Exchange Online, você precisa executar o cmdlet New-AvailabilityConfig antes de executar o cmdlet Add-AvailabilityAddressSpace.

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

Add-AvailabilityAddressSpace -ForestName example.contoso.com -AccessMethod OrgWideFB -Credentials (Get-Credential)

Este exemplo é útil quando um serviço de disponibilidade entre florestas não é confiável ou quando um serviço de disponibilidade entre florestas detalhado não é desejável. Insira um nome de usuário e uma senha quando você for solicitado pelo comando. Para uma configuração entre florestas não confiável, certifique-se de que o usuário não tem uma caixa de correio.

Exemplo 2

Add-AvailabilityAddressSpace -ForestName example.contoso.com -AccessMethod PerUserFB -Credentials (Get-Credential)

Este exemplo é útil com um serviço de disponibilidade confiável entre florestas. A floresta contoso.com confia na floresta atual e a conta especificada conecta-se à floresta contoso.com. A conta especificada deve ser uma conta existente na floresta contoso.com.

Exemplo 3

Add-AvailabilityAddressSpace -ForestName example.contoso.com -AccessMethod PerUserFB -UseServiceAccount $true

Este exemplo é útil com um serviço de disponibilidade confiável entre florestas. A floresta contoso.com confia na floresta atual e usa a conta do serviço (normalmente a conta do sistema local ou a conta do computador) para se conectar à floresta contoso.com. Como o serviço é confiável, não há problemas de autorização quando a floresta atual tenta recuperar informações de disponibilidade de contoso.com.

Parâmetros

-AccessMethod

O parâmetro AccessMethod especifica como os dados de disponibilidade são acessados. Os valores válidos são:

  • PerUserFB: informações gratuitas/ocupadas por usuário podem ser solicitadas. Os dados gratuitos/ocupados são acessados na conta ou grupo ou grupo de proxy livre/ocupado definido por usuário ou no grupo Todos os Servidores do Exchange. Esse valor exige uma relação de confiança entre duas florestas e exige que você use o parâmetro UseServiceAccount ou o parâmetro Credentials.
  • OrgWideFB: somente o padrão gratuito/ocupado para cada usuário pode ser solicitado. Os dados de disponibilidade são acessados na conta de proxy de disponibilidade por usuário ou grupo na floresta de destino. Esse valor exige que você use o parâmetro UseServiceAccount ou o parâmetro Credentials.
  • OrgWideFBBasic: esse valor é reservado para uso interno de Microsoft.
  • InternalProxy: a solicitação é proxied para um Exchange no site que tem uma versão posterior do Exchange.
  • PublicFolder: esse valor foi usado para acessar dados gratuitos/ocupados em Exchange Server 2003 servidores.
Type:AvailabilityAccessMethod
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

-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

-Credentials

O parâmetro Credenciais especifica o nome de usuário e a senha usados para acessar os serviços de disponibilidade na floresta de destino.

Um valor para esse parâmetro requer o cmdlet Get-Credential. Para pausar o comando e receber uma solicitação de credenciais, use o valor (Get-Credential). Ou, antes de executar esse comando, armazene as credenciais em uma variável (por exemplo, $cred = Get-Credential) e, em seguida, use o nome da variável ($cred) para esse parâmetro. Para saber mais, confira Obter credencial.

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

-ForestName

O parâmetro ForestName especifica o nome de domínio SMTP da floresta de destino para usuários cujos dados de disponibilidade precisam ser recuperados. Se os usuários estiverem distribuídos entre vários domínios SMTP na floresta de destino, execute o cmdlet Add-AvailabilityAddressSpace separadamente para cada domínio SMTP.

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

-ProxyUrl

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

O parâmetro ProxyUrl foi usado para especificar a URL que direcionou um servidor de Acesso ao Cliente do Exchange 2007 para proxy de suas solicitações gratuitas/ocupadas por meio de um servidor de Acesso ao Cliente do Exchange 2010 ou Exchange 2013 ao solicitar dados federados gratuitos/ocupados para um usuário em outra organização. Quando você usou esse parâmetro, foi necessário definir o valor do parâmetro AccessMethod como InternalProxy.

Esse parâmetro exigia que você criasse as relações de confiança adequadas e compartilhasse relações entre as organizações do Exchange. Para mais informações, consulte New-FederationTrust.

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

-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.xml. O Exchange usa o Autodiscover para detectar automaticamente o ponto de extremidade correto do servidor para solicitações externas.

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

-UseServiceAccount

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

O parâmetro UseServiceAccount especifica se é necessário usar a conta de serviço de disponibilidade local para autorização. Valores válidos

  • $true: a conta de serviço de disponibilidade local é usada para autorização.
  • $false: a conta de serviço de disponibilidade local não é usada para autorização. É necessário usar o parâmetro Credentials.
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

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