Compartilhar via


New-OwaVirtualDirectory

 

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

Tópico modificado em: 2010-02-25

O cmdlet New-OWAVirtualDirectory cria um novo diretório virtual do Outlook Web Access em um site do IIS (Serviços de Informações da Internet) existente que execute o Microsoft Exchange Server 2007.

Sintaxe

New-OwaVirtualDirectory [-Name <String>] [-ApplicationRoot <String>] [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OwaVersion <Exchange2003or2000 | Exchange2007>] [-Path <String>] [-TemplateInstance <PSObject>] [-VirtualDirectoryType <NotSpecified | Mailboxes | PublicFolders | Exchweb | Exadmin>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Por padrão, quando o Exchange 2007 é instalado, os seguintes diretórios virtuais do Outlook Web Access são criados no site padrão do IIS do servidor local que está executando o Microsoft Exchange:

  • Owa   Um diretório virtual do Exchange 2007 Outlook Web Access.

  • Exchange   Um diretório virtual herdado do Outlook Web Access que pode ser acessado por usuários que tenham caixas de correio nos servidores que estão executando o Exchange Server 2003 ou o Exchange 2000 Server.

  • Public   Um diretório virtual herdado do Outlook Web Access que aponta para as pastas públicas nos servidores que estão executando o Exchange 2003 ou o Exchange 2000.

  • Exchweb   Um diretório virtual herdado do Outlook Web Access que os usuários podem usar para acessar os diretórios virtuais do Outlook Web Access. Por padrão, as solicitações ao diretório virtual exchweb são enviadas para o servidor de Caixa de Correio do usuário.

    Dica

    Geralmente, você usa o cmdlet New-OWAVirtualDirectory se tiver necessidades comerciais especiais que exijam diretórios virtuais adicionais, como hospedagem, ou para tarefas de solução de problemas do Outlook Web Access, como exclusão e recriação de um diretório virtual do Outlook Web Access.

O cmdlet New-OwaVirtualDirectory deverá ser executado no servidor Exchange 2007 que está hospedando a função de servidor Acesso para Cliente em que você deseja hospedar o novo diretório virtual. A conta à qual esteja delegada a função Administrador do Exchange Server e a associação no grupo Administradores local do 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 2007, consulte Considerações sobre permissão

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

ApplicationRoot

Opcional

System.String

Esse parâmetro define o caminho do diretório virtual na metabase.

Dica

Esse parâmetro não foi implementado.

AppPoolId

Opcional

System.String

Este parâmetro define o pool de aplicativos do IIS em que o Outlook Web Access será executado. É melhor deixá-lo definido como o padrão.

Confirm

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro 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

Este parâmetro especifica o FQDN (nome de domínio totalmente qualificado) do controlador de domínio que recupera dados do serviço de diretório do Active Directory.

ExternalAuthenticationMethods

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parâmetro, uma configuração da propriedade Descoberta de Serviços, especifica os métodos de autenticação que têm suporte no servidor Exchange de fora do firewall.

Dica

Esse parâmetro não foi implementado, mas pode ser definido usando Set-OwaVirtualDirectory.

ExternalUrl

Opcional

System.Uri

Este parâmetro especifica o nome de host usado para conectar ao servidor Exchange de fora do firewall. Esta configuração também é importante quando SSL (Secure Sockets Layer) é usado.

Dica

Você pode definir essa configuração somente nos diretórios virtuais do Exchange 2007. O diretório virtual padrão do Exchange 2007 é /owa.

InternalUrl

Opcional

System.Uri

Este parâmetro especifica o nome do host do servidor Exchange para conexão de dentro do firewall. Esta configuração também é importante quando SSL é usado.

Dica

Você pode definir essa configuração somente nos diretórios virtuais do Exchange 2007. O diretório virtual padrão do Exchange 2007 é /owa.

Name

Opcional

System.String

Este parâmetro especificará o nome de um diretório virtual do Outlook Web Access se o diretório virtual do Outlook Web Access estiver em um servidor com Exchange 2003 ou Exchange 2000.

Se o diretório virtual do Outlook Web Access estiver em um servidor Exchange 2007, o parâmetro será ignorado.

OWAVersion

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.OwaVersions

Este parâmetro especifica se a versão do diretório virtual do Outlook Web Access é Exchange 2007, Exchange 2003 ou Exchange 2000.

Path

Opcional

System.String

Esse parâmetro define o caminho do sistema de arquivos do diretório virtual. Esse parâmetro deve ser usado com cuidado e somente quando você tiver de usar um caminho do sistema de arquivos diferente do padrão.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Esse parâmetro especifica que o cmdlet usará a configuração de um objeto existente, quando o objeto for fornecido para esse parâmetro, para criar uma cópia idêntica do objeto em um servidor local ou de destino.

Dica

Esse parâmetro não foi implementado.

VirtualDirectoryType

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.VirtualDirectoryTypes

Este parâmetro especifica se o diretório virtual do Outlook Web Access aponta para caixas de correio, pastas públicas ou exchweb. Ele será obrigatório se o diretório virtual do Outlook Web Access estiver em um servidor Exchange 2003 ou Exchange 2000.

Se o diretório virtual do Outlook Web Access estiver em um servidor Exchange 2007, este parâmetro será ignorado.

WebSiteName

Opcional

System.String

Este parâmetro especifica o nome do site do IIS em que o diretório virtual do Outlook Web Access é criado.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

Este parâmetro instrui o comando a simular as ações que ele executaria 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 nenhum valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

Os exemplos de código a seguir criam um conjunto de novos diretórios virtuais herdados do Outlook Web Access com os nomes "exchange", "public" e "exchweb" em um site do IIS diferente do padrão, chamado "contoso.com", no Exchange Server local.

New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Mailboxes -Name "exchange" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType PublicFolders -Name "public" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Exchweb -Name "exchweb" -WebSiteName "Contoso.com"