New-UMVirtualDirectory
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2007-06-28
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>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-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 de UM.
Para executar o cmdlet New-UMVirtualDirectory, você deve usar uma conta à qual esteja delegada a função Administrador do Exchange 2007 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(s) | Tipo | Descrição |
|---|---|---|---|
ApplicationRoot |
Opcional |
System.String |
Esse parâmetro especifica o caminho do site definido na metabase do IIS (Serviços de Informações da Internet). Por padrão, o caminho está definido como /W3SVC/1/ROOT, em que 1 = o site padrão. |
AppPoolId |
Opcional |
System.String |
Esse parâmetro especifica 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, o nome do pool está definido como MSExchangeUMAppPool. |
BasicAuthentication |
Opcional |
System.Boolean |
Esse parâmetro especifica se a autenticação Básica está habilitada no diretório virtual. |
DigestAuthentication |
Opcional |
System.Boolean |
Esse parâmetro especifica se a autenticação Resumida está habilitada no diretório virtual. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Este parâmetro 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 |
Esse parâmetro especifica 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 Active Directory. |
ExternalUrl |
Opcional |
System.Uri |
Esse parâmetro especifica o nome do host que será usado para conectar ao servidor do Exchange de fora da rede de perímetro. |
InternalUrl |
Opcional |
System.Uri |
Este parâmetro especifica o nome do host do servidor Exchange para conexão de dentro da rede de perímetro. |
Path |
Opcional |
System.String |
Este parâmetro especifica 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 |
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. |
WebSiteName |
Opcional |
System.String |
Esse parâmetro especifica o nome do site em que 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 |
Esse parâmetro especifica se a autenticação Integrada do Windows está habilitada no diretório virtual. |
WhatIf |
Optional |
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 é $true. |
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"