New-ActiveSyncVirtualDirectory

 

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

Ultima modifica dell'argomento: 2009-05-14

Il comando New-ActiveSyncVirtualDirectory consente di creare nuove directory virtuali di Microsoft Exchange ActiveSync nei siti Web specificati.

Sintassi

New-ActiveSyncVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallProxySubDirectory <$true | $false>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Il comando New-ActiveSyncVirtualDirectory consente di creare una nuova directory virtuale di Exchange ActiveSync nel server specificato nel sito Web indicato. Il nome assegnato alla directory virtuale di Exchange ActiveSync creata sarà "Microsoft-ActiveSync-Server". Una sola directory virtuale di Exchange ActiveSync può esistere in ciascun sito Web di Exchange ActiveSync.

Per eseguire il cmdlet New-ActiveSyncVirtualDirectory, è necessario utilizzare un account che disponga della delega del ruolo di Exchange Server Administrator e del gruppo Administrators locale per il server di destinazione.

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange Server 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 gruppo di programmi che è possibile utilizzare con la directory virtuale.

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Mediante il parametro Confirm viene determinata la sospensione dell'elaborazione tramite il comando e richiesto all'amministratore di riconoscere l'operazione eseguita dal comando stesso prima che l'elaborazione continui. Il valore predefinito è $true.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN) del controller di dominio tramite cui viene scritta la modifica della configurazione nel servizio directory di Active Directory.

ExternalAuthenticationMethods

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare i metodi di autenticazione supportati nel server che contiene la directory virtuale quando l'accesso viene richiesto dall'esterno del firewall di rete. Se il parametro non viene specificato, è possibile utilizzare tutti i metodi di autenticazione.

ExternalUrl

Facoltativo

System.Uri

Questo parametro consente di specificare l'URL utilizzato per connettersi alla directory virtuale da una posizione esterna al firewall di rete.

InstallProxySubDirectory

Facoltativo

System.Boolean

Il parametro InstallProxySubDirectory controlla come creare la nuova sottodirectory Exchange ActiveSync utilizzata come proxy tra Microsoft Exchange Server 2010 e Exchange Server 2007. 

InternalAuthenticationMethods

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare i metodi di autenticazione supportati nel server che contiene la directory virtuale quando l'accesso viene richiesto dall'interno del firewall di rete. Se il parametro non viene specificato, è possibile utilizzare tutti i metodi di autenticazione.

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 la directory che contiene i file di sistema della directory virtuale.

TemplateInstance

Facoltativo

System.Management.Automation.PSObject

Quando per questo parametro viene specificato un oggetto esistente, tramite il cmdlet viene utilizzata la configurazione dell'oggetto affinché questo venga duplicato in un server locale o di destinazione.

WebSiteName

Facoltativo

System.String

Questo parametro consente di specificare il nome del sito Web di Exchange ActiveSync nel quale creare la nuova directory virtuale.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Questo parametro consente di indicare al comando di simulare le azioni da eseguire sull'oggetto. Utilizzando il parametro WhatIf, l'amministratore può visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Il valore predefinito è $false.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

Eccezioni

Eccezioni Descrizione

Esempio

Il seguente codice di esempio consente di creare una nuova directory virtuale nel server Contoso.

New-ActiveSyncVirtualDirectory -Server "Contoso" -WebSiteName "Default Web Site" -ExternalURL "https://www.contoso.com/Microsoft-Server-ActiveSync"