Get-MapiVirtualDirectory
Este cmdlet está disponível somente no Exchange local.
Utilize o cmdlet Get-MapiVirtualDirectory para ver diretórios virtuais da Interface de Programação de Aplicações de Mensagens (MAPI) que são utilizados nos Serviços de Informação Internet (IIS) nos servidores do Microsoft Exchange. Um diretório virtual MAPI é utilizado por versões suportadas do Microsoft Outlook para ligar a caixas de correio através do protocolo MAPIHTTP.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Server
Get-MapiVirtualDirectory
-Server <ServerIdParameter>
[-ADPropertiesOnly]
[-DomainController <Fqdn>]
[-ShowMailboxVirtualDirectories]
[<CommonParameters>]
Identity
Get-MapiVirtualDirectory
[[-Identity] <VirtualDirectoryIdParameter>]
[-ADPropertiesOnly]
[-DomainController <Fqdn>]
[-ShowMailboxVirtualDirectories]
[<CommonParameters>]
Description
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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
Estes exemplos devolvem informações detalhadas para o diretório virtual MAPI com o nome "mapi (Web Site Predefinido)" no servidor com o nome 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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O comutador ADPropertiesOnly especifica se deve devolver apenas as propriedades do diretório virtual armazenadas no Active Directory. Não é preciso especificar um valor com essa opção.
Se não utilizar este comutador, as propriedades no Active Directory e na metabase dos Serviços de Informação Internet (IIS) são devolvidas.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 Nome utiliza a sintaxe "VirtualDirectoryName (WebsiteName)" das propriedades do diretório virtual. Pode especificar o caráter universal (*) em vez do site predefinido com a sintaxe VirtualDirectoryName*.
Não é possível usar os parâmetros Identity e Server no mesmo comando.
Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | VirtualDirectoryIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Server
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro Server especifica o servidor Exchange que aloja 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.
Propriedades do parâmetro
| Tipo: | ServerIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Server
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ShowMailboxVirtualDirectories
Aplicável: Exchange Server 2013
Este parâmetro só está disponível no Exchange Server 2013.
O comutador 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 predefinição, este cmdlet mostra informações sobre diretórios virtuais nos serviços de Acesso de Cliente nos servidores da Caixa de Correio. As ligações de cliente são efetuadas a partir dos serviços de Acesso de Cliente nos servidores da Caixa de Correio para os serviços de back-end nos servidores da 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.