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 ambiente ou de outro.
Use o cmdlet Add-AvailabilityAddressSpace para criar objetos de espaço de endereço de disponibilidade que são usados para compartilhar dados de disponibilidade entre organizações do Exchange.
O número máximo de espaços de endereço de Disponibilidade retornados pelo Active Directory para o 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.
Sintaxe
Default (Default)
Add-AvailabilityAddressSpace
-AccessMethod <AvailabilityAccessMethod>
-ForestName <String>
[-Confirm]
[-Credentials <PSCredential>]
[-DomainController <Fqdn>]
[-ProxyUrl <Uri>]
[-TargetAutodiscoverEpr <Uri>]
[-TargetServiceEpr <String>]
[-TargetTenantId <String>]
[-UseServiceAccount <Boolean>]
[-WhatIf]
[<CommonParameters>]
Description
No Exchange Online, você precisa executar o cmdlet do New-AvailabilityConfig antes de executar o cmdlet Add-AvailabilityAddressSpace.
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
Add-AvailabilityAddressSpace -ForestName contoso.com -AccessMethod OrgWideFB -Credentials (Get-Credential)
No Exchange local, esse exemplo é útil com um serviço de disponibilidade entre florestas não confiável ou se o serviço detalhado de disponibilidade entre florestas não for desejado. Insira um nome de usuário e senha quando 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 contoso.com -AccessMethod PerUserFB -Credentials (Get-Credential)
No Exchange local, esse exemplo é útil com um serviço confiável de disponibilidade 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 contoso.com -AccessMethod PerUserFB -UseServiceAccount $true
No Exchange local, esse exemplo é útil com um serviço confiável de disponibilidade 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.
Exemplo 4
Add-AvailabilityAddressSpace -ForestName contoso.onmicrosoft.com -AccessMethod OrgWideFBToken -TargetTenantId "9d341953-da1f-41b0-8810-76d6ef905273" -TargetServiceEpr "outlook.office.com"
No Exchange Online, este exemplo configura o compartilhamento de informações de disponibilidade com o contoso.onmicrosoft.com (valor de ID do locatário 9d341953-da1f-41b0-8810-76d6ef905273), que é uma organização regular do Microsoft 365.
Parâmetros
-AccessMethod
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 AccessMethod especifica como os dados de disponibilidade são acessados. Os valores válidos são:
- PerUserFB: Informações de disponibilidade por usuário podem ser solicitadas. Os dados de disponibilidade são acessados na conta ou no grupo proxy de disponibilidade por usuário definido 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 a disponibilidade padrão de cada usuário pode ser solicitada. 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. Esse valor foi preterido para acessar florestas de destino no Exchange Online.
- OrgWideFBToken: usado para compartilhamento de disponibilidade entre dois locatários no Exchange Online. Somente a disponibilidade padrão de cada usuário pode ser solicitada. Esse valor também exige que você defina os parâmetros TargetTenantId e TargetServiceEpr.
- InternalProxy: a solicitação é enviada por proxy para um servidor Exchange no site que está executando uma versão posterior do Exchange.
- PublicFolder: esse valor foi usado para acessar os dados de disponibilidade nos servidores do Exchange Server 2003.
Propriedades do parâmetro
| Tipo: | AvailabilityAccessMethod |
| 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 |
-Confirm
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 Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
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 |
-Credentials
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 Credentials 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.
Propriedades do parâmetro
| Tipo: | PSCredential |
| 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 |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| 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 |
-ForestName
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 ForestName especifica o nome de domínio SMTP da floresta de destino que contém os usuários dos quais você está tentando ler as informações de disponibilidade. Se os usuários estiverem distribuídos entre vários domínios SMTP na floresta de destino, execute o comando Add-AvailabilityAddressSpace uma vez para cada domínio SMTP.
Propriedades do parâmetro
| Tipo: | String |
| 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 |
-ProxyUrl
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ProxyUrl foi usado para especificar a URL que direcionava um servidor de Acesso para Cliente do Exchange 2007 para solicitações de proxy de disponibilidade por meio de um servidor de Acesso para Cliente do Exchange 2010 ou Exchange 2013 ao solicitar dados federados de disponibilidade para um usuário em outra organização. Ao usar esse parâmetro, você precisava definir o valor do parâmetro AccessMethod como InternalProxy.
Esse parâmetro exigia que você criasse as relações de confiança adequadas e as relações de compartilhamento entre as organizações do Exchange. Para mais informações, consulte New-FederationTrust.
Propriedades do parâmetro
| Tipo: | Uri |
| 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 |
-TargetAutodiscoverEpr
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para caixas de correio locais
O parâmetro TargetAutodiscoverEpr especifica a URL de Descoberta Automática dos Serviços Web do Exchange para a organização externa da qual você está tentando ler informações de disponibilidade. Por exemplo, https://contoso.com/autodiscover/autodiscover.xml. O Exchange usa a Descoberta Automática para detectar automaticamente o ponto de extremidade correto do servidor para solicitações externas.
Propriedades do parâmetro
| Tipo: | Uri |
| 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 |
-TargetServiceEpr
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro TargetServiceEpr especifica o endereço do Exchange Online da organização externa do Microsoft 365 da qual você está tentando ler as informações de disponibilidade. Os valores válidos são:
- Microsoft 365 ou Microsoft 365 GCC: outlook.office.com
- Office 365 operado pela 21Vianet: partner.outlook.cn
- Microsoft 365 GCC High ou DoD: outlook.office365.us
Você usa esse parâmetro somente quando o valor do parâmetro AccessMethod é OrgWideFBToken.
Propriedades do parâmetro
| Tipo: | String |
| 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 |
-TargetTenantId
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro TargetTenantID especifica a ID do locatário da organização externa do Microsoft 365 da qual você está tentando ler as informações de disponibilidade.
Você usa esse parâmetro somente quando o valor do parâmetro AccessMethod é OrgWideFBToken.
Propriedades do parâmetro
| Tipo: | String |
| 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 |
-UseServiceAccount
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | Boolean |
| 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 |
-WhatIf
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 WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
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.