Set-OABVirtualDirectory

  • Artigo

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2009-05-14

Use o cmdlet Set-OABVirtualDirectory para alterar as definições de configuração de um diretório virtual do OAB (catálogo de endereços offline).

Sintaxe

Set-OabVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-PollInterval <Int32>] [-RequireSSL <$true | $false>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

Set-OabVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADOabVirtualDirectory>] [-InternalUrl <Uri>] [-PollInterval <Int32>] [-RequireSSL <$true | $false>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

Descrição detalhada

Esse cmdlet Set-OABVirtualDirectory permite alterar a configuração de um ponto de distribuição na Web do OAB em um servidor de Acesso para Cliente.

Para executar o cmdlet Set-OABVirtualDirectory, você deve usar a conta à qual esteja delegado o seguinte:

  • Função de Administrador do Exchange Server e grupo Administradores local para o servidor de destino

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

Utilize o parâmetro Identity para especificar a GUID, o nome distinto ou o nome do diretório virtual do catálogo de endereços offline que representa um diretório virtual específico do catálogo de endereços offline. Você pode também incluir o caminho utilizando o formato Server\OfflineAddressBookVirtualDirectoryName.

Você pode omitir o rótulo do parâmetro Identity para que somente o nome do diretório do catálogo de endereços offline ou a GUID seja fornecido.

BasicAuthentication

Opcional

System.Boolean

O parâmetro BasicAuthentication especifica se a Autenticação básica está habilitada no diretório virtual do OAB.

Confirm

Optional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado do controlador de domínio que recupera dados do Active Directory, inclua o parâmetro DomainController no comando.

ExternalUrl

Opcional

System.Uri

Esse parâmetro especifica o URL externo para o qual o diretório virtual do OAB aponta.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADOabVirtualDirectory

O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.

InternalUrl

Opcional

System.Uri

Esse parâmetro especifica o URL interno para o qual o diretório virtual do OAB aponta.

PollInterval

Opcional

System.Int32

O intervalo de tempo em que o serviço de distribuição deve sondar o servidor de geração quanto a novas atualizações (em minutos).

RequireSSL

Opcional

System.Boolean

Quando configurado como $true, esse parâmetro exige o uso de SSL (Secure Sockets Layer) para acessar o diretório virtual do OAB.

WhatIf

Optional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

WindowsAuthentication

Opcional

System.Boolean

O parâmetro WindowsAuthentication especifica se a autenticação do Windowsestá habilitada no diretório virtual do OAB.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

Exceções

Exceções Descrição

Exemplo

Esse exemplo configura o endereço da Web externo do diretório virtual do OAB.

Set-OABVirtualDirectory -Identity "Server1\OAB (Default Web Site)" -ExternalURL "https://www.contoso.com/OAB"