Set-WebServicesVirtualDirectory

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2011-06-21

Il cmdlet Set-WebServicesVirtualDirectory consente di modificare una directory virtuale dei Servizi Web Exchange esistente in un computer Exchange 2007 in cui è installato il ruolo del server Accesso client.

Sintassi

Set-WebServicesVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

Set-WebServicesVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADWebServicesVirtualDirectory>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

Descrizione dettagliata

Il cmdlet Set-WebServicesVirtualDirectory consente di modificare una directory virtuale dei Servizi Web Exchange esistente in un server Accesso client di Exchange 2007.

Nota

Se si dispone di un insieme con carico bilanciato di server Accesso client, non è necessario specificare il nome di ciascun server quando viene eseguito il cmdlet. È sufficiente utilizzare solo il nome di uno dei server con carico bilanciato presenti nella rete.

Per eseguire il cmdlet Set-WebServicesVirtualDirectory, è necessario utilizzare un account a cui sia stato delegato il ruolo Exchange Server Administrator e l'appartenenza 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 Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

Questo parametro consente di specificare il nome della directory virtuale. È inoltre possibile specificare un carattere jolly invece del Sito Web predefinito.

BasicAuthentication

Facoltativo

System.Boolean

Questo parametro consente di specificare se l'autenticazione di base è abilitata nella directory virtuale di Servizi Web Exchange. Il parametro può essere utilizzato con FormsAuthentication oppure con DigestAuthentication e WindowsAuthentication.

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro Confirm 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.

DigestAuthentication

Facoltativo

System.Boolean

Questo parametro consente di specificare se l'autenticazione con classificazione è abilitata nella directory virtuale.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di recuperare i dati dal servizio directory 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 Exchange all'esterno del firewall. Tale impostazione è importante anche quando si utilizza Secure Sockets Layer (SSL).

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADWebServicesVirtualDirectory

Il parametro Instance consente di trasmettere l'intero oggetto al cmdlet da elaborare.

InternalNLBBypassUrl

Facoltativo

System.Uri

Questo parametro consente di specificare l'URL del server Accesso client anche se tale server si trova dietro a un dispositivo di bilanciamento del carico di rete (NLB).

InternalUrl

Facoltativo

System.Uri

Questo parametro consente di specificare il nome host del server Exchange per la connessione all'interno del firewall. Tale impostazione è importante anche quando si utilizza SSL.

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.

WindowsAuthentication

Facoltativo

System.Boolean

Questo parametro consente di specificare se l'autenticazione di Windows integrata è consentita nella directory virtuale di Servizi Web Exchange.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Eccezioni

Eccezioni Descrizione

 

 

Esempio

Il seguente codice di esempio consente di impostare il metodo di autenticazione su Di base per la directory virtuale denominata "EWS" nel server "Contoso". Inoltre, tale codice consente di impostare l'URL interno e l'URL esterno della directory virtuale.

Nel secondo esempio di codice viene utilizzato un carattere jolly invece del "sito Web predefinito".

Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.asmx - BasicAuthentication $true InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.asmx