Get-MapiVirtualDirectory
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet Get-MapiVirtualDirectory per visualizzare le directory virtuali MAPI (Message Application Programming Interface) utilizzate in Internet Information Services (IIS) nei server Microsoft Exchange. Una directory virtuale MAPI viene utilizzata dalle versioni supportate di Microsoft Outlook per connettersi alle cassette postali usando il protocollo MAPIHTTP.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Server
Get-MapiVirtualDirectory
-Server <ServerIdParameter>
[-ADPropertiesOnly]
[-DomainController <Fqdn>]
[-ShowMailboxVirtualDirectories]
[<CommonParameters>]
Identity
Get-MapiVirtualDirectory
[[-Identity] <VirtualDirectoryIdParameter>]
[-ADPropertiesOnly]
[-DomainController <Fqdn>]
[-ShowMailboxVirtualDirectories]
[<CommonParameters>]
Descrizione
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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 (Default Web Site)" sul 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
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 utilizza questa opzione, vengono restituite le proprietà in Active Directory e nella metabase di Internet Information Services (IIS).
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DomainController
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | Fqdn |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 utilizza la sintassi "VirtualDirectoryName (WebsiteName)" delle proprietà della directory virtuale. È possibile specificare il carattere jolly (*) anziché il sito Web predefinito utilizzando la sintassi VirtualDirectoryName*.
Non è possibile utilizzare entrambi i parametri Identity e Server nello stesso comando.
Attenzione: il valore $null o un valore inesistente per il parametro Identity restituisce tutti gli oggetti come se si eseguisse il comando Get- senza il parametro Identity. Verificare che tutti gli elenchi di valori per il parametro Identity siano accurati e non contengano valori $null inesistenti.
Proprietà dei parametri
| Tipo: | VirtualDirectoryIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Server
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro Server consente di specificare il server di 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.
Proprietà dei parametri
| Tipo: | ServerIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Server
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-ShowMailboxVirtualDirectories
Applicabile: 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 le informazioni sulle directory virtuali nei servizi Accesso client sui server Cassette postali. Le connessioni client vengono inoltrate tramite 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.
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.