New-ActiveSyncVirtualDirectory (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-06-11
O comando New-ActiveSyncVirtualDirectory permite criar novos diretórios virtuais do Microsoft Exchange ActiveSync em sites especificados.
Sintaxe
New-ActiveSyncVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-Path <String>] [-Server <ServerIdParameter>] [-TemplateInstance <PSObject>] [-WebSiteName <String>]
Descrição detalhada
O comando New-ActiveSyncVirtualDirectory determina um novo diretório virtual do Exchange ActiveSync a ser criado no servidor e site especificados. 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, voce deve usar a conta a qual estejam delegadas as seguintes funçoes:
- 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 |
|---|---|---|---|
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. |
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ção de configuração no Active Directory, inclua o parâmetro DomainController no comando. |
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 externamente ao firewall da rede. |
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. |
Server |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Esse parâmetro define o servidor no qual o novo diretório virtual do Exchange ActiveSync será criado. |
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Quando um objeto existente for fornecido para esse parâmetro, o comando usará a configuração desse objeto para criar uma duplicata exata do 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. |
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 "Contoso/Default Web Site" -ExternalURL "https://www.contoso.com/Microsoft-Server-ActiveSync"