Set-ActiveSyncVirtualDirectory (RTM)

Artículo
06/26/2014

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-11

El comando Set-ActiveSyncVirtualDirectory le permite configurar las opciones de Microsoft ActiveSync en un directorio virtual especificado.

Sintaxis

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>]

Descripción detallada

El comando Set-ActiveSyncVirtualDirectory le permite configurar una variedad de opciones en el directorio virtual que se utiliza para Exchange ActiveSync.

Para ejecutar el cmdlet Set-ActiveSyncVirtualDirectory, debe utilizar una cuenta en la que se delegue lo siguiente:

Función de administrador de servidores de Exchange y grupo Administradores local para el servidor de destino

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro	Necesario	Tipo	Descripción
Identity	Necesario	Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter	Este parámetro identifica de manera única el directorio virtual de Exchange ActiveSync que se va a configurar. Este valor debe ser website\microsoft-server-activesync.
ActiveSyncServer	Opcional	System.String	Este parámetro especifica la URL del servidor de Acceso de cliente. Tendrá el formato siguiente: https://nombreservidor/Microsoft-Server-ActiveSync.
BadItemReportingEnabled	Opcional	System.Boolean	Este parámetro especifica si se debería informar al usuario de los elementos que no se pueden sincronizar. Si se establece en `$true`, el usuario recibe una notificación cuando un elemento no se puede sincronizar con el dispositivo móvil.
BasicAuthEnabled	Opcional	System.Boolean	Este parámetro habilita o deshabilita la autenticación básica. El valor predeterminado es `$true`.
ClientCertAuth	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.ClientCertAuthTypes	Este parámetro especifica el estado de la autenticación de certificados de cliente. De manera predeterminada, la autenticación de certificados de cliente está deshabilitada. El valor predeterminado de este parámetro es `$null`.
CompressionEnabled	Opcional	System.Boolean	Este parámetro es un número entero que identifica la compresión aplicada al directorio virtual de Exchange ActiveSync especificado El valor predeterminado es `$true`.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el comando.
ExternalAuthenticationMethods	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Este parámetro especifica los métodos de autenticación admitidos por el servidor que contiene el directorio virtual cuando se solicita acceso desde fuera del firewall de la red. Si no está establecido este parámetro, pueden utilizarse todos los métodos de autenticación.
ExternalUrl	Opcional	System.Uri	Este parámetro especifica la URL que se utiliza para conectarse al directorio virtual desde fuera del firewall de la red.
Instance	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.ADMobileVirtualDirectory	El parámetro Instance le permite pasar un objeto entero al comando que se va a procesar. Se utiliza principalmente en scripts donde hay que pasar un objeto entero al comando.
InternalAuthenticationMethods	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Este parámetro especifica los métodos de autenticación admitidos por el servidor que contiene el directorio virtual cuando se solicita acceso desde dentro del firewall de la red. Si no está establecido este parámetro, pueden utilizarse todos los métodos de autenticación.
InternalUrl	Opcional	System.Uri	Este parámetro se utiliza para la función Proxy HTTP del servidor de Acceso de cliente. Si se establece, el servidor de Acceso de cliente que está recibiendo las conexiones de cliente entrantes enviará las solicitudes a esta URL. Puede ser una URL de nombre de dominio completo (FQDN) expuesta a Internet o un nombre de host interno.
MobileClientCertificateAuthorityURL	Opcional	System.String	Este parámetro especifica la URL de la entidad de certificación (CA) que utiliza el dispositivo móvil.
MobileClientCertificateProvisioningEnabled	Opcional	System.Boolean	Este parámetro especifica si el servicio de detección automática devolverá la URL del servidor de servicios de certificados en el archivo XML.
MobileClientCertTemplateName	Opcional	System.String	Este parámetro especifica el nombre de plantilla del certificado de cliente.
Name	Opcional	System.String	Este parámetro especifica el nombre del directorio virtual de Exchange ActiveSync.
RemoteDocumentsActionForUnknownServers	Opcional	System.Nullable	Este parámetro especifica la acción que se produce cuando entra una solicitud de recursos compartidos de archivos de Windows o Windows SharePoint Services a través de Exchange ActiveSync. Cuando se recibe una solicitud, Exchange ActiveSync busca el nombre de host solicitado en las listas de permitidos y no permitidos. Si el nombre de host no se encuentra en ninguna de las listas, se realiza la acción especificada en este parámetro, ya sea bloquear o admitir.
RemoteDocumentsAllowedServers	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Este parámetro es una propiedad de varios valores que enumera todos los servidores permitidos para el acceso de documentos remoto.
RemoteDocumentsBlockedServers	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Este parámetro es una propiedad de varios valores que enumera todos los servidores bloqueados para el acceso de documentos remoto.
RemoteDocumentsInternalDomainSuffixList	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Este parámetro se utiliza en organizaciones que no ejecutan WINS en su red. En estos entornos, puede especificar uno o varios FQDN que Exchange ActiveSync trata como internos cuando se recibe una solicitud de acceso a un archivo remoto.

Tipos de entrada

Tipos de valores devueltos

Errores

Error	Descripción

Excepciones

Excepciones	Descripción

Ejemplo

El siguiente código de ejemplo deshabilita la autenticación básica en el directorio virtual de Exchange ActiveSync predeterminado en el servidor denominado Contoso.

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