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"