New-UMVirtualDirectory (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-06-11
O cmdlet New-UMVirtualDirectory permite que você crie um novo diretório virtual no computador que esteja executando o Microsoft Exchange Server 2007 em que a função de servidor Acesso para Cliente esteja instalada.
Sintaxe
New-UMVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WindowsAuthentication <$true | $false>]
Descrição detalhada
O cmdlet New-UMVirtualDirectory permite que você crie um diretório virtual de Unificação de Mensagens no servidor de Acesso para Cliente do Exchange 2007. Você pode criar um único ou vários diretórios virtuais do UM.
Para executar o cmdlet New-UMVirtualDirectory, você deve usar uma conta à qual estejam delegadas as seguintes funções:
- 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 |
Use esse parâmetro para especificar o caminho do site definido na metabase do IIS (Serviço de Informações da Internet). Por padrão, ele está definido como /W3SVC/1/ROOT, onde 1 = o site padrão. |
AppPoolId |
Opcional |
System.String |
Use esse parâmetro para especificar o nome do pool de aplicativos do IIS. Essa definição pode ser configurada em <NOMEDOSERVIDOR>\Pools de Aplicativos no site no Gerenciador do IIS. Por padrão, ele está definido como MSExchangeUMAppPool. |
BasicAuthentication |
Opcional |
System.Boolean |
Use esse parâmetro para especificar se a Autenticação básica está habilitada no diretório virtual. |
DigestAuthentication |
Opcional |
System.Boolean |
Use esse parâmetro para especificar se a autenticação resumida está habilitada no 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 serviço de diretório do Active Directory, inclua o parâmetro DomainController no cmdlet. |
ExternalUrl |
Opcional |
System.Uri |
Use esse parâmetro para especificar o nome do host que será usado para conectar ao servidor Exchange de fora da rede de perímetro. |
InternalUrl |
Opcional |
System.Uri |
Use este parâmetro para especificar o nome do host do servidor Exchange para conexão de dentro da rede de perímetro. |
Path |
Opcional |
System.String |
Use este parâmetro para especificar o caminho local no servidor de Acesso para Cliente onde os arquivos do UMWebservice estão localizados. O local padrão é %ExchangeInstallDir%\UnifiedMessaging\WebService. |
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Se 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 |
WebSiteName |
Opcional |
System.String |
Use esse parâmetro para especificar o nome do site no qual o novo diretório virtual será criado. Esse parâmetro não deve ser usado quando você estiver criando um novo diretório virtual no site padrão. |
WindowsAuthentication |
Opcional |
System.Boolean |
Use esse parâmetro para especificar se a Autenticação do Windows Integrada deve ser habilitada no diretório virtual. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
|
Exemplo
Este exemplo de código cria um novo diretório virtual de Unificação de Mensagens chamado MyUMWeb.
New-UMVirtualDirectory -MyUMWeb -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/UMwebservices.aspx"