New-OwaVirtualDirectory
Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Ultima modifica dell'argomento: 2010-02-25
Il cmdlet New-OWAVirtualDirectory consente di creare una nuova directory virtuale di Outlook Web Access in un sito Web esistente di Internet Information Services (IIS) su un computer su cui viene eseguito Microsoft Exchange Server 2007.
Sintassi
New-OwaVirtualDirectory [-Name <String>] [-ApplicationRoot <String>] [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OwaVersion <Exchange2003or2000 | Exchange2007>] [-Path <String>] [-TemplateInstance <PSObject>] [-VirtualDirectoryType <NotSpecified | Mailboxes | PublicFolders | Exchweb | Exadmin>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Per impostazione predefinita, quando viene installato Exchange 2007, le seguenti directory virtuali di Outlook Web Access vengono create nel sito Web di IIS predefinito sul server locale sul quale è in esecuzione Microsoft Exchange:
OWA Una directory virtuale di Exchange 2007 Outlook Web Access.
Exchange Una directory virtuale legacy di Outlook Web Access a cui possono accedere gli utenti che dispongono di cassette postali sui server sui quali è in esecuzione Exchange Server 2003 o Exchange 2000 Server.
Public Una directory virtuale legacy di Outlook Web Access che fa riferimento alle cartelle pubbliche sui server sui quali è in esecuzione Exchange 2003 o Exchange 2000.
Exchweb Una directory virtuale legacy di Outlook Web Access utilizzata per accedere alle directory virtuali di Outlook Web Access. Per impostazione predefinita, le richieste alla directory virtuale exchweb vengono inviate al server Cassette postali dell'utente.
Nota
In genere, il cmdlet New-OWAVirtualDirectory viene utilizzato in caso di particolari esigenze aziendali che richiedono directory virtuali aggiuntive, ad esempio per l'hosting o per attività di risoluzione dei problemi di Outlook Web Access quali l'eliminazione e la ricostruzione di una directory virtuale.
Il cmdlet New-OwaVirtualDirectory deve essere eseguito sul server Exchange 2007 che ospita il ruolo del server Accesso client in cui a sua volta dovrà essere ospitata la nuova directory virtuale. È necessario utilizzare un account che disponga della delega del ruolo Exchange Server Administrator e appartenga al gruppo Administrators locale del server di destinazione.
Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange 2007, vedere Considerazioni sulle autorizzazioni.
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
ApplicationRoot |
Facoltativo |
System.String |
Questo parametro consente di impostare il percorso della directory virtuale nella metabase. Nota Questo parametro non è stato implementato. |
AppPoolId |
Facoltativo |
System.String |
Questo parametro consente di impostare il pool di applicazioni di IIS in cui verrà eseguito Outlook Web Access. Si consiglia di non modificare l'impostazione predefinita del parametro. |
Confirm |
Facoltativo |
System.Management.Automation.SwitchParameter |
Questo parametro consente di determinare la sospensione dell'elaborazione e di richiedere che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con il parametro Confirm non è necessario specificare un valore. |
DomainController |
Facoltativo |
Microsoft.Exchange.Data.Fqdn |
Questo parametro consente di specificare il nome di dominio completo (FQDN) del controller di dominio che recupera i dati dal servizio directory di Active Directory. |
ExternalAuthenticationMethods |
Facoltativo |
Microsoft.Exchange.Data.MultiValuedProperty |
Questo parametro, un'impostazione della proprietà Services Discovery, consente di specificare i metodi di autenticazione supportati sul server Exchange dall'esterno del firewall. Nota Questo parametro non è stato implementato, ma può essere impostato utilizzando Set-OwaVirtualDirectory. |
ExternalUrl |
Facoltativo |
System.Uri |
Questo parametro consente di specificare il nome host utilizzato per la connessione al server Exchange dall'esterno del firewall. Tale impostazione è importante anche quando si utilizza Secure Sockets Layer (SSL). Nota L'impostazione può essere configurata solo nelle directory virtuali di Exchange 2007. La directory virtuale predefinita di Exchange 2007 è /owa. |
InternalUrl |
Facoltativo |
System.Uri |
Questo parametro consente di specificare il nome dell'host del server Exchange per la connessione dall'interno del firewall. Tale impostazione è importante anche quando si utilizza SSL. Nota L'impostazione può essere configurata solo nelle directory virtuali di Exchange 2007. La directory virtuale predefinita di Exchange 2007 è /owa. |
Name |
Facoltativo |
System.String |
Questo parametro consente di specificare il nome di una directory virtuale di Outlook Web Access qualora tale directory virtuale sia presente su un server su cui viene eseguito Exchange Server 2003 o Exchange 2000. Se la directory virtuale di Outlook Web Access si trova su un server Exchange 2007, il parametro verrà ignorato. |
OWAVersion |
Facoltativo |
Microsoft.Exchange.Data.Directory.SystemConfiguration.OwaVersions |
Questo parametro consente di specificare se la versione della directory virtuale di Outlook Web Access è Exchange 2007, Exchange 2003 o Exchange 2000. |
Path |
Facoltativo |
System.String |
Questo parametro imposta il percorso del file system della directory virtuale. Si consiglia di utilizzare con attenzione questo parametro e solo nel caso in cui occorre utilizzare un percorso del file system diverso da quello predefinito. |
TemplateInstance |
Facoltativo |
System.Management.Automation.PSObject |
Quando per questo parametro viene specificato un oggetto esistente, il cmdlet utilizza la configurazione dell'oggetto per crearne una copia identica in un server locale o di destinazione. Nota Questo parametro non è stato implementato. |
VirtualDirectoryType |
Facoltativo |
Microsoft.Exchange.Data.Directory.SystemConfiguration.VirtualDirectoryTypes |
Questo parametro consente di specificare se la directory virtuale di Outlook Web Access fa riferimento a cassette postali, cartelle pubbliche o a exchweb. È obbligatorio se la directory virtuale di Outlook Web Access si trova su un server Exchange 2003 o Exchange 2000. Se la directory virtuale di Outlook Web Access si trova su un server Exchange 2007, il parametro verrà ignorato. |
WebSiteName |
Facoltativo |
System.String |
Questo parametro consente di specificare il nome del sito Web di IIS in cui viene creata la directory virtuale di Outlook Web Access. |
WhatIf |
Facoltativo |
System.Management.Automation.SwitchParameter |
Questo parametro consente al comando di simulare le azioni da intraprendere sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore. |
Tipi di input
Tipi restituiti
Errori
| Errore | Descrizione |
|---|---|
|
|
Eccezioni
| Eccezioni | Descrizione |
|---|---|
|
|
Esempio
Nei seguenti esempi di codice viene creato un nuovo insieme di directory virtuali legacy di Outlook Web Access denominate "exchange", "pubblica" ed "exchweb" in un sito Web di IIS non predefinito, denominato "contoso.com" sul server di Exchange locale.
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Mailboxes -Name "exchange" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType PublicFolders -Name "public" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Exchweb -Name "exchweb" -WebSiteName "Contoso.com"