New-ActiveSyncVirtualDirectory
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2009-05-14
O comando New-ActiveSyncVirtualDirectory permite criar novos diretórios virtuais do Microsoft Exchange ActiveSync em sites especificados.
Sintaxe
New-ActiveSyncVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallProxySubDirectory <$true | $false>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O comando New-ActiveSyncVirtualDirectory faz com que um novo diretório virtual do Exchange ActiveSync seja criado no servidor no site especificado. O diretório virtual do Exchange ActiveSync é criado com o nome "Microsoft-Server-ActiveSync". Só pode existir um único diretório virtual do Exchange ActiveSync em cada site do Exchange ActiveSync.
Para executar o cmdlet New-ActiveSyncVirtualDirectory, você deve usar uma conta à qual esteja delegada a função Administrador do Exchange Server e o 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 Server 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 de metabase do diretório virtual. Por padrão, esse caminho é o mesmo do site em que o diretório virtual foi criado. |
AppPoolId |
Opcional |
System.String |
Esse parâmetro define o pool de programas que podem ser utilizados com o diretório virtual. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro Confirm faz com que o comando pause o processamento e exige que o administrador confirme o que o comando fará antes que o processamento continue. O valor padrão é $true. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteraçao de configuraçao no serviço de diretório Active Directory. |
ExternalAuthenticationMethods |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Esse parâmetro especifica os métodos de autenticação com suporte do servidor que contém o diretório virtual quando o acesso é solicitado externamente ao firewall da rede. Se esse parâmetro não estiver definido, todos os métodos de autenticação poderão ser usados. |
ExternalUrl |
Opcional |
System.Uri |
Esse parâmetro especifica a URL utilizada para conectar ao diretório virtual de fora do firewall da rede. |
InstallProxySubDirectory |
Optional |
System.Boolean |
O parâmetro InstallProxySubDirectory controla como criar o novo subdiretório do Exchange ActiveSync que é usado como um proxy entre o Microsoft Exchange Server 2010 e o Exchange Server 2007. |
InternalAuthenticationMethods |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Esse parâmetro especifica os métodos de autenticação com suporte do servidor que contém o diretório virtual quando o acesso é solicitado de dentro do firewall da rede. Se esse parâmetro não estiver definido, todos os métodos de autenticação poderão ser usados. |
InternalUrl |
Opcional |
System.Uri |
Esse parâmetro especifica a URL utilizada para conectar ao diretório virtual de dentro do firewall da rede. |
Path |
Opcional |
System.String |
Esse parâmetro define o diretório que contém os arquivos de sistema do diretório virtual. |
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 duplicar o objeto em um servidor local ou de destino. |
WebSiteName |
Opcional |
System.String |
Esse parâmetro especifica o nome do site do Exchange ActiveSync em que o novo diretório virtual será 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, o administrador poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. O valor padrão é $false. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
Exceções
| Exceções | Descrição |
|---|---|
Exemplo
O exemplo de código a seguir cria um novo diretório virtual no servidor Contoso.
New-ActiveSyncVirtualDirectory -Server "Contoso" -WebSiteName "Default Web Site" -ExternalURL "https://www.contoso.com/Microsoft-Server-ActiveSync"