Set-ActiveSyncVirtualDirectory

Artículo
06/26/2014

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2012-03-26

El comando Set-ActiveSyncVirtualDirectory le permite configurar las opciones de Microsoft Exchange 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>] [-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>]

Descripción detallada

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

Para ejecutar el cmdlet Set-ActiveSyncVirtualDirectory, debe usar una cuenta que tenga delegada la función Administrador de Exchange y pertenezca al grupo local Administradores del servidor de destino.

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft 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`.
Confirm	Opcional	System.Management.Automation.SwitchParameter	Este parámetro hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.
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 usarse todos los métodos de autenticación.
ExternalUrl	Opcional	System.Uri	Este parámetro especifica la URL que se usa para conectarse al directorio virtual desde fuera del firewall de la red.
InstallIsapiFilter	Opcional	System.Boolean	El parámetro InstallIsapiFilter especifica si está instalado el filtro Internet Server API (ISAPI).
InstallProxySubDirectory	Opcional	System.Boolean	El parámetro InstallProxySubDirectory controla cómo se crea el nuevo subdirectorio de Exchange ActiveSync que se usa como proxy entre Microsoft Exchange Server 2010 y Exchange Server 2007.
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 usarse todos los métodos de autenticación.
InternalUrl	Opcional	System.Uri	Este parámetro se usa 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 dirección 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 usa 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.
WhatIf	Opcional	System.Management.Automation.SwitchParameter	Este parámetro indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso de este parámetro, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar ningún valor con este parámetro.
WindowsAuthEnabled	Opcional	System.Boolean	Este parámetro especifica si la autenticación de Windows integrada está habilitada en el directorio virtual de Exchange ActiveSync.

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