Get-MapiVirtualDirectory

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Get-MapiVirtualDirectory para exibir diretórios virtuais MAPI (Interface de Programação de Aplicativo de Mensagem) que são usados no IIS (Serviços de Informações da Internet) em servidores Microsoft Exchange. Um diretório virtual MAPI é usado por versões compatíveis do Microsoft Outlook para se conectar às caixas de correio usando o protocolo MAPIHTTP.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-MapiVirtualDirectory
   -Server <ServerIdParameter>
   [-ADPropertiesOnly]
   [-DomainController <Fqdn>]
   [-ShowMailboxVirtualDirectories]
   [<CommonParameters>]
Get-MapiVirtualDirectory
   [[-Identity] <VirtualDirectoryIdParameter>]
   [-ADPropertiesOnly]
   [-DomainController <Fqdn>]
   [-ShowMailboxVirtualDirectories]
   [<CommonParameters>]

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-MapiVirtualDirectory -Server ContosoMail

Este exemplo retorna uma lista resumida de todos os diretórios virtuais MAPI no servidor chamado ContosoMail.

Exemplo 2

Get-MapiVirtualDirectory -Identity "ContosoMail\mapi (Default Web Site)" | Format-List

Get-MapiVirtualDirectory "ContosoMail\mapi (Default Web Site)" | Format-List

Get-MapiVirtualDirectory ContosoMai\mapi* | Format-List

Esses exemplos retornam informações detalhadas para o diretório virtual MAPI chamado "mapi (Site Padrão)" no servidor chamado ContosoMail. Todos os três comandos fazem a mesma coisa.

Exemplo 3

Get-MapiVirtualDirectory

Este exemplo retorna uma lista resumida de todos os diretórios virtuais do MAPI no serviço de acesso para cliente em todos os servidores de Caixa de Correio na organização.

Parâmetros

-ADPropertiesOnly

A opção ADPropertiesOnly especifica se deve retornar apenas as propriedades do diretório virtual armazenadas no Active Directory. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, as propriedades no Active Directory e na metabase do IIS (Serviços de Informações da Internet) serão retornadas.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identity especifica o diretório virtual MAPI que você deseja exibir. É possível usar qualquer valor que identifique exclusivamente o diretório virtual. Por exemplo:

  • Nome ou Servidor\Nome
  • DN (nome diferenciado)
  • GUID

O valor Name usa a sintaxe "VirtualDirectoryName (WebsiteName)" das propriedades do diretório virtual. Você pode especificar o caractere curinga (*) em vez do site padrão usando a sintaxe VirtualDirectoryName*.

Não é possível usar os parâmetros Identity e Server no mesmo comando.

Type:VirtualDirectoryIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

O parâmetro Server especifica o servidor exchange que hospeda o diretório virtual. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

  • Nome
  • FQDN
  • DN (nome diferenciado)
  • ExchangeLegacyDN

Não é possível usar os parâmetros Server e Identity no mesmo comando.

Type:ServerIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ShowMailboxVirtualDirectories

Esse parâmetro só está disponível no Exchange Server 2013.

A opção ShowMailboxVirtualDirectories mostra informações sobre diretórios virtuais de back-end em servidores de caixa de correio. Não é preciso especificar um valor com essa opção.

Por padrão, este cmdlet mostra informações sobre diretórios virtuais nos serviços de Acesso ao Cliente em servidores de caixa de correio. As conexões do cliente são proxied dos serviços de Acesso ao Cliente em servidores de caixa de correio para os serviços de back-end em servidores de caixa de correio. Os clientes não se conectam diretamente aos serviços de back-end.

Por padrão, esse cmdlet mostra informações sobre diretórios virtuais nos serviços de Acesso para Cliente em servidores de Caixa de Correio. As conexões do cliente são feitas por proxy dos serviços de Acesso para Cliente nos servidores de Caixa de Correio para os serviços de back-end nos servidores de Caixa de Correio. Os clientes não se conectam diretamente aos serviços de back-end.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.