Set-ActiveSyncVirtualDirectory

 

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

Ultima modifica dell'argomento: 2012-03-26

Il comando Set-ActiveSyncVirtualDirectory consente di configurare le impostazioni di Microsoft Exchange ActiveSync in una determinata directory virtuale.

Sintassi

Set-ActiveSyncVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallIsapiFilter <$true | $false>] [-InstallProxySubDirectory <$true | $false>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthEnabled <$true | $false>]

Set-ActiveSyncVirtualDirectory [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallIsapiFilter <$true | $false>] [-InstallProxySubDirectory <$true | $false>] [-Instance <ADMobileVirtualDirectory>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthEnabled <$true | $false>]

Descrizione dettagliata

Il comando Set-ActiveSyncVirtualDirectory consente di configurare varie impostazioni nella directory virtuale utilizzata per Exchange ActiveSync.

Per eseguire il cmdlet Set-ActiveSyncVirtualDirectory, è 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 identifica in modo univoco la directory virtuale di Exchange ActiveSync da configurare. È necessario che il valore sia website\microsoft-server-activesync.
ActiveSyncServer	Facoltativo	System.String	Questo parametro consente di specificare l'URL del server Accesso client, il cui formato è riportato di seguito: https://servername/Microsoft-Server-ActiveSync.
BadItemReportingEnabled	Facoltativo	System.Boolean	Questo parametro specifica se è necessario notificare all'utente gli elementi che non è possibile sincronizzare. Se si imposta su $true, l'utente riceve una notifica sul dispositivo portatile quando non è possibile sincronizzare un elemento.
BasicAuthEnabled	Facoltativo	System.Boolean	Questo parametro abilita o disabilita l'autenticazione di base. L'impostazione predefinita è $true.
ClientCertAuth	Facoltativo	Microsoft.Exchange.Data.Directory.SystemConfiguration.ClientCertAuthTypes	Questo parametro specifica lo stato dell'autenticazione del certificato client. Per impostazione predefinita, l'autenticazione del certificato client è disabilitata. Il valore predefinito di questo parametro è $null.
CompressionEnabled	Facoltativo	System.Boolean	Questo parametro è rappresentato da un numero intero che identifica la compressione applicata alla directory virtuale di Exchange ActiveSync specificata. L'impostazione predefinita è $true.
Confirm	Facoltativo	System.Management.Automation.SwitchParameter	Questo parametro consente di determinare la sospensione dell'elaborazione e richiede 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	Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di scrivere la modifica alla configurazione nel servizio directory di Active Directory, includere nel comando il parametro DomainController.
ExternalAuthenticationMethods	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Questo parametro consente di specificare i metodi di autenticazione supportati dal 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 collegarsi alla directory virtuale dall'esterno del firewall di rete.
InstallIsapiFilter	Facoltativo	System.Boolean	Il parametro InstallIsapiFilter specifica se è installato il filtro ISAPI (Internet Server Application Programming Interface).
InstallProxySubDirectory	Facoltativo	System.Boolean	Il parametro InstallProxySubDirectory controlla la creazione della nuova sottodirectory Exchange ActiveSync che viene utilizzata come proxy tra Microsoft Exchange Server 2010 e Exchange Server 2007.
Instance	Facoltativo	Microsoft.Exchange.Data.Directory.SystemConfiguration.ADMobileVirtualDirectory	Il parametro Instance consente di passare un oggetto intero al comando per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare un oggetto intero al comando.
InternalAuthenticationMethods	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Questo parametro consente di specificare i metodi di autenticazione supportati dal 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 è utilizzato per la caratteristica Proxy HTTP del server Accesso client. Se è impostato, il server Acceso Client che riceve connessioni client in ingresso invia le richieste tramite proxy a questo URL. È possibile che si tratti di un nome dominio completo (FQDN) Internet oppure di un nome host interno.
MobileClientCertificateAuthorityURL	Facoltativo	System.String	Questo parametro specifica l'URL relativo all'Autorità di certificazione (CA) utilizzata dal dispositivo portatile.
MobileClientCertificateProvisioningEnabled	Facoltativo	System.Boolean	Questo parametro specifica se il servizio di individuazione automatica deve restituire l'URL del server Servizi certificati nel file XML.
MobileClientCertTemplateName	Facoltativo	System.String	Questo parametro consente di specificare il nome del modello relativo al certificato client.
Name	Facoltativo	System.String	Questo parametro consente di specificare il nome della directory virtuale di Exchange ActiveSync.
RemoteDocumentsActionForUnknownServers	Facoltativo	System.Nullable	Questo parametro specifica quale azione si verifica quando arriva una richiesta di Windows SharePoint Services o di condivisione di file Windows via Exchange ActiveSync. Quando arriva una richiesta, Exchange ActiveSync esegue una ricerca del nome host richiesto negli elenchi Consenti e Blocca. Se il nome host non viene trovato in entrambi gli elenchi, l'azione specificata in questo parametro, ossia Blocca o Consenti, viene eseguita.
RemoteDocumentsAllowedServers	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Questo parametro rappresenta una proprietà con più valori che elenca tutti i server a cui è consentito l'accesso a documenti remoti.
RemoteDocumentsBlockedServers	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Questo parametro rappresenta una proprietà con più valori che elenca tutti i server a cui non è consentito l'accesso a documenti remoti.
RemoteDocumentsInternalDomainSuffixList	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Questo parametro è utilizzato nelle organizzazioni che non eseguono WINS nella rispettiva rete. In tali ambienti, è possibile specificare uno o più FQDN che sono trattati da Exchange ActiveSync come interni quando si riceve una richiesta di accesso a file remoti.
WhatIf	Facoltativo	System.Management.Automation.SwitchParameter	Questo parametro consente di indicare al comando di simulare le azioni da eseguire sull'oggetto. Il parametro consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Non è necessario specificare alcun valore con questo parametro.
WindowsAuthEnabled	Facoltativo	System.Boolean	Questo parametro consente di specificare se l'autenticazione di Windows integrata è abilitata nella directory virtuale di Exchange ActiveSync.

Tipi di input

Tipi restituiti

Errori

Errore	Descrizione

Eccezioni

Eccezioni	Descrizione

Esempio

L'esempio di codice seguente disabilita l'autenticazione di base nella directory virtuale predefinita di Exchange ActiveSync nel server denominato Contoso.

Set-ActiveSyncVirtualDirectory -Identity "contoso\microsoft-server-activesync" -BasicAuthEnabled:$false