New-WebServicesVirtualDirectory
Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Ultima modifica dell'argomento: 2007-08-20
Il cmdlet New-WebServicesVirtualDirectory consente di creare una nuova directory virtuale denominata EWS sul computer che esegue Microsoft Exchange Server 2007 e in cui è installato il ruolo del server Accesso client.
Sintassi
New-WebServicesVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Descrizione dettagliata
Il cmdlet New-WebServicesVirtualDirectory consente di creare una nuova directory virtuale denominata EWS nel server Accesso client di Exchange 2007. Mediante questo cmdlet, è possibile creare più directory virtuali.
Nota
È possibile creare una sola directory virtuale EWS per ogni sito Web.
Per eseguire il cmdlet New-WebServicesVirtualDirectory, è necessario utilizzare un account che disponga della delega del ruolo Exchange Server Administrator e che 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 del metabase della directory virtuale. Per impostazione predefinita, questo percorso è uguale al sito Web in cui è stata creata la directory virtuale. |
AppPoolId |
Facoltativo |
System.String |
Questo parametro consente di impostare il pool di programmi che è possibile utilizzare con la directory virtuale. |
BasicAuthentication |
Facoltativo |
System.Boolean |
Questo parametro consente di specificare se l'autenticazione di base è abilitata nella directory virtuale EWS. |
Confirm |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro Confirm determina l'interruzione dell'elaborazione del comando e richiede che l'utente, prima che l'elaborazione continui, confermi l'operazione che verrà eseguita dal comando. Con il parametro Confirm non è necessario specificare un valore. |
DigestAuthentication |
Facoltativo |
System.Boolean |
Questo parametro, quando utilizzato, consente di specificare l'utilizzo dell'Autenticazione del digest della directory virtuale. |
DomainController |
Facoltativo |
Microsoft.Exchange.Data.Fqdn |
Per specificare il nome di dominio completo (FQDN, fully qualified domain name) del controller di dominio che scrive la modifica alla configurazione nel servizio directory di Active Directory, includere nel cmdlet il parametro DomainController. |
ExternalUrl |
Facoltativo |
System.Uri |
Questo parametro consente di specificare il nome host che verrà utilizzato per connettersi al server di Exchange dall'esterno della rete perimetrale. |
InternalNLBBypassUrl |
Facoltativo |
System.Uri |
Il parametro indica l'URL del server Accesso client, indipendentemente dal posizionamento in un array di Bilanciamento carico di rete (NLB, Network Load Balancing). Sebbene il parametro InternalUrl venga inviato all'URL del NLB, il parametro InternalNLBBypassUrl deve essere sempre impostato sull'URL del server Accesso client. Tale situazione si verifica poiché alcune chiamate dei servizi Web di Exchange richiedono affinità di dispositivo e i servizi Web di Exchange eseguono proxy sulle chiamate in ingresso a server di Accesso client più appropriati qualora possibile. |
InternalUrl |
Facoltativo |
System.Uri |
Questo parametro consente di specificare l'URL utilizzato per collegarsi alla directory virtuale dall'interno del firewall di rete. |
Path |
Facoltativo |
System.String |
Questo parametro consente di impostare il percorso della directory virtuale nella metabase. |
TemplateInstance |
Facoltativo |
System.Management.Automation.PSObject |
Quando per questo parametro viene specificato un oggetto esistente, il comando utilizza la configurazione dell'oggetto per crearne una copia in un server locale o di destinazione. |
WebSiteName |
Facoltativo |
System.String |
Questo parametro consente di specificare il nome del sito Web all'interno del quale creare la nuova directory virtuale. Questo parametro non dovrebbe essere utilizzato durante la creazione di una nuova directory virtuale all'interno del sito Web predefinito. |
WindowsAuthentication |
Facoltativo |
System.Boolean |
Utilizzare questo parametro per specificare se un'autenticazione integrata di Windows è consentita nella nuova directory virtuale dei servizi Web di Exchange. |
WhatIf |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro WhatIf 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
In questo esempio di codice viene creata una nuova directory virtuale chiamata "contoso" con URL esterna impostata su "https://www.contoso.com/webservices.aspx".
New-WebServicesVirtualDirectory -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/webservices.aspx"