Set-ActiveSyncVirtualDirectory (RTM)

Articolo
08/07/2014

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-11

Il comando Set-ActiveSyncVirtualDirectory consente di configurare le impostazioni di Microsoft 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>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>]

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

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 che disponga della seguente delega:

Ruolo Exchange Server Administrator e 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 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`.
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.
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.
Nome	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.

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

Condividi tramite