New-WebServicesVirtualDirectory

Articolo
08/07/2014

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"

Condividi tramite