Get-MapiVirtualDirectory

Riferimento

Modulo:: ExchangePowerShell

Si applica a:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Questo cmdlet è disponibile solo in Exchange locale.

Usare il cmdlet Get-MapiVirtualDirectory per visualizzare le directory virtuali MAPI (Message Application Programming Interface) usate in Internet Information Services (IIS) nei server Exchange Microsoft. Una directory virtuale MAPI viene usata dalle versioni supportate di Microsoft Outlook per connettersi alle cassette postali tramite il protocollo MAPIHTTP.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

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

Descrizione

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Get-MapiVirtualDirectory -Server ContosoMail

In questo esempio viene restituito un elenco riepilogativo di tutte le directory virtuali MAPI sul server denominato ContosoMail.

Esempio 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

Questi esempi restituiscono informazioni dettagliate per la directory virtuale MAPI denominata "mapi (sito Web predefinito)" nel server denominato ContosoMail. I tre comandi eseguono la medesima operazione.

Esempio 3

Get-MapiVirtualDirectory

In questo esempio viene restituito un elenco riepilogativo di tutte le directory virtuali MAPI nei servizi Accesso client su tutti i server Cassette postali nell'organizzazione.

Parametri

-ADPropertiesOnly

L'opzione ADPropertiesOnly specifica se restituire solo le proprietà della directory virtuale archiviate in Active Directory. Con questa opzione non è necessario specificare alcun valore.

Se non si usa questa opzione, vengono restituite le proprietà in Active Directory e nella metabase di Internet Information Services (IIS).

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

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, 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

Il parametro Identity consente di specificare la directory virtuale MAPI che si desidera visualizzare. È possibile utilizzare qualsiasi valore che identifichi la directory virtuale in modo univoco. Ad esempio:

Nome o Server\Nome
Nome distinto (DN)
GUID

Il valore Name usa la sintassi "VirtualDirectoryName (WebsiteName)" delle proprietà della directory virtuale. È possibile specificare il carattere jolly (*) anziché il sito Web predefinito usando la sintassi VirtualDirectoryName*.

Non è possibile utilizzare entrambi i parametri Identity e Server nello stesso 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

Il parametro Server specifica il server Exchange che ospita la directory virtuale. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:

Nome
FQDN
Nome distinto (DN)
ExchangeLegacyDN

Non è possibile utilizzare entrambi i parametri Server e Identity nello stesso 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

Questo parametro è disponibile solo in Exchange Server 2013.

L'opzione ShowMailboxVirtualDirectories mostra informazioni sulle directory virtuali back-end nei server Cassette postali. Con questa opzione non è necessario specificare alcun valore.

Per impostazione predefinita, questo cmdlet mostra informazioni sulle directory virtuali nei servizi Accesso client nei server Cassette postali. Le connessioni client vengono sottoposte a proxy dai servizi Accesso client nei server Cassette postali ai servizi back-end nei server Cassette postali. I client non si connettono direttamente ai servizi back-end.

Per impostazione predefinita, questo cmdlet consente di visualizzare le informazioni relative alle directory virtuali nei servizi Accesso client sui server Cassette postali. Le connessioni client vengono inviate tramite proxy dai servizi Accesso client sui server Cassette postali ai servizi back-end sui server Cassette postali. I client non si connettono direttamente ai servizi back-end.

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

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.

Condividi tramite