New-OwaVirtualDirectory (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-11-15
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>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OwaVersion <Exchange2003or2000 | Exchange2007>] [-Path <String>] [-TemplateInstance <PSObject>] [-VirtualDirectoryType <NotSpecified | Mailboxes | PublicFolders | Exchweb | Exadmin>] [-WebSiteName <String>]
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 do IIS padrão do servidor Exchange local.
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 Exchange Server 2003 ou Exchange 2000 Server.
Public Um diretório virtual herdado do Outlook Web Access que aponta para as pastas públicas nos servidores Exchange Server 2003 ou Exchange 2000 Server.
Exchweb Um diretório virtual herdado do Outlook Web Access que os usuários usam 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. Para executar o cmdlet New-OwaVirtualDirectory, você deve usar uma conta à qual esteja delegada a função Administrador do Exchange Server e a associação ao 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 | 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. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. |
ExternalAuthenticationMethods |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ExternalAuthenticationMethods, 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 (RTM). |
ExternalUrl |
Opcional |
System.Uri |
Este parâmetro especifica o nome de host usado para conectar ao servidor Exchange de fora do firewall. Essa 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. Essa 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 Server 2003 ou Exchange 2000 Server. 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 for necessário usar um caminho do sistema de arquivos diferente do padrão. |
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Quando um objeto existente for fornecido a esse parâmetro, o comando usará a configuração desse objeto para criar uma cópia idêntica do objeto no 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. |
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"