Set-SPExcelFileLocation
Establece las propiedades de una ubicación de archivo de confianza para la aplicación de Servicios de Excel.
Syntax
Set-SPExcelFileLocation
[-Identity] <SPExcelFileLocationPipeBind>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AbortOnRefreshOnOpenFail]
[-Address <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-AutomaticVolatileFunctionCacheLifetime <Int32>]
[-ChartAndImageSizeMax <Int32>]
[-ConcurrentDataRequestsPerSessionMax <Int32>]
[-Confirm]
[-DefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
[-Description <String>]
[-DisplayGranularExtDataErrors]
[-ExternalDataAllowed <AllowExternalData>]
[-IncludeChildren]
[-LocationType <LocationType>]
[-ManualExtDataCacheLifetime <Int32>]
[-NewWorkbookSessionTimeout <Int32>]
[-PeriodicExtDataCacheLifetime <Int32>]
[-RequestDurationMax <Int32>]
[-RESTExternalDataAllowed]
[-SessionTimeout <Int32>]
[-ShortSessionTimeout <Int32>]
[-UdfsAllowed]
[-WarnOnDataRefresh]
[-WhatIf]
[-WorkbookSizeMax <Int32>]
[-ChartRenderDurationMax <Int32>]
[<CommonParameters>] Description
El Set-SPExcelFileLocation cmdlet establece las propiedades de una ubicación desde la que Excel Services Application carga libros.
Excel Services Application solo carga los libros almacenados en una ubicación de archivo de confianza.
Las propiedades de las ubicaciones de archivos de confianza controlan cómo se pueden usar los libros cuando se cargan en Excel Services aplicación.
Excel Services Application siempre aplica las propiedades definidas por la ubicación de archivo de confianza desde la que se cargó un libro.
Las propiedades usadas por la ubicación de archivos de confianza se determinan comparando la ruta del archivo del libro con el parámetro Address de la ubicación de archivos de confianza.
Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.
Ejemplos
--------------EJEMPLO 1------------
Get-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed DclEn este ejemplo se obtienen todas las ubicaciones de archivos de confianza de la aplicación de servicio web de aplicación Excel Services denominada My Excel Service que permite que las conexiones de datos se carguen desde archivos de libro y especifica que las ubicaciones deben usar una biblioteca de conexiones de datos para cargar conexiones de datos.
--------------EJEMPLO 2------------
Get-SPExcelServiceApplication | Get-SPExcelFileLocation | where {$_.Address -eq "https://"} | Set-SPExcelFileLocation -Description "This is the default trusted file location for Excel Services Application. It allows any file from anywhere in SharePoint to load."En este ejemplo se cambia la descripción de la ubicación de archivo predeterminada para cada aplicación de servicio web de aplicación Excel Services de la granja de servidores.
Parámetros
-AbortOnRefreshOnOpenFail
Especifica que la carga de un archivo de aplicación de Excel Services produce un error automáticamente si se produce un error en una operación de actualización automática de datos cuando se abre el archivo. Se produce un error en la carga solo si las siguientes condiciones son verdaderas:
-- El usuario tiene permisos de solo lectura para el archivo de aplicación de Excel Services. -- El archivo del libro tiene conexiones de datos que se actualizan automáticamente cuando se abre el archivo de Excel.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Address
System.String
Especifica una carpeta web o directorio de archivos desde el que Excel Services Aplicación puede cargar libros.
El tipo debe ser una dirección URL válida, en el formulario https://myPortal/myTeam; o una ruta de acceso UNC válida en forma, \\server_name\folder_name
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-AssignmentCollection
Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.
Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global.
Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-AutomaticVolatileFunctionCacheLifetime
Especifica el tiempo máximo es segundos que se almacena en la memoria caché un valor computado para una función volátil con el fin de realizar nuevos cálculos automáticos. Los valores válidos incluyen:
-1: calcular una vez al cargar el libro
0: calcular siempre
1 a 2073600: almacenar en la memoria caché de 1 segundo a 24 días
El tipo debe ser los números enteros -1 o 0 o un valor entero entre 1 y 2073600
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ChartAndImageSizeMax
Especifica el tamaño máximo en megabytes de un gráfico o imagen que se puede abrir. El valor predeterminado es 1.
El tipo debe ser un número entero válido mayor que 0.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ChartRenderDurationMax
El tiempo máximo (en segundos) dedicado a representar cualquier gráfico único.
Valores válidos: -1 (sin límite); de 1 a 2073600 (24 días).
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ConcurrentDataRequestsPerSessionMax
Especifica en número máximo de solicitudes de datos externos concurrentes que se permite en cada sesión. Si una sesión debe asignar más solicitudes que este número, se deben situar solicitudes adicionales en cola. El ámbito de este ajuste es el servidor lógico. El valor predeterminado es 5.
El tipo debe ser un entero positivo.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Confirm
Le pide confirmación antes de ejecutar el comando.
Para obtener más información, escriba el siguiente comando: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-DefaultWorkbookCalcMode
Especifica el modo de cálculo de los libros. Todos los ajustes excepto File invalidan los ajustes del libro. Si se cambia este parámetro, se aplica a todas las sesiones nuevas de Excel Services Application cuando se actualiza la caché de propiedades de ConfigDB. El valor predeterminado es File.
El tipo debe ser uno de los siguientes: File, Manual, Auto o AutoDataTables.
| Type: | DefaultWorkbookCalcMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Description
Especifica una descripción simplificada de la nueva ubicación del archivo.
El tipo debe ser una cadena válida; por ejemplo, "Ésta es la ubicación del archivo del informe de ventas mensuales".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-DisplayGranularExtDataErrors
Muestra mensajes de error granulares para los archivos de esta ubicación con error en los datos externos.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ExcelServiceApplication
Especifica la aplicación de servicio web de aplicación Excel Services que contiene el objeto de lista SPExcelFileLocation.
El tipo debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh; un nombre válido de una aplicación de servicio web de aplicación de Excel Services en la granja de servidores (por ejemplo, MyExcelService1); o una instancia de un objeto SPExcelServiceApplication válido.
| Type: | SPExcelServiceApplicationPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ExternalDataAllowed
Especifica el tipo de acceso a datos externos permitido para los libros: Ninguno especifica que la actualización de datos está deshabilitada. Dcl especifica que los datos se actualizan únicamente cuando usan un archivo de conexión en una Biblioteca de conexiones de datos de confianza. DclandEmbedded especifica que se puede usar una Biblioteca de conexiones de datos, aunque no es obligatoria. El ámbito de este valor es la ubicación de confianza.
El valor predeterminado es None.
El tipo debe ser uno de los siguientes: None, Dcl o DclAndEmbedded.
| Type: | AllowExternalData |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Identity
Especifica el objeto FileLocation para actualizar. El nombre debe ser único en la lista de ubicaciones de archivos.
El tipo debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh; una cadena válida que identifica la ubicación del archivo, con el formato https://myPortal/myTeam; una cadena válida que identifica la ruta de acceso, con el formato C:\folder_name; o una instancia de un objeto SPExcelFileLocation válido.
| Type: | SPExcelFileLocationPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-IncludeChildren
Indica que las direcciones URL subordinadas, directorios y bibliotecas son de confianza. Por ejemplo, si la ubicación de archivo de confianza es https://portaly IncludeChildren es true, https://portal/subSite también es de confianza, al igual que cualquier subURL en la dirección URL especificada en Dirección.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-LocationType
El tipo de ubicación. LocationType indica cómo Excel Services Application recupera los archivos de esa ubicación especificada en Dirección. El valor predeterminado es SharePoint.
El tipo debe ser uno de los siguientes: SharePoint, UNC o HTTP.
| Type: | LocationType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ManualExtDataCacheLifetime
Especifica el tiempo, en segundos, que Excel Services aplicación espera antes de volver a emitir una solicitud de datos externa manual o iniciada por el usuario. Durante este período, es posible que se devuelvan los resultados de la solicitud de datos externos anterior de una memoria caché de datos externos.
Los valores admitidos son:
-1 No actualizar nunca después de la primera consulta
De 1 a 2073600 cachés de 1 segundo a 24 días.
El valor predeterminado es 300.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-NewWorkbookSessionTimeout
Especifica el tiempo, en segundos, que una sesión de un nuevo libro, sin guardar, permanecerá activa en Excel Services aplicación sin actividad de usuario. El valor predeterminado es 1800. Valores válidos:
-1, la sesión nunca expira
0, la sesión expira al final de una sola solicitud
1 a 2073600, permanece activo de 1 segundo a 24 días.
El tipo debe ser -1, 0 o un número entero entre 1 y 2073600.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-PeriodicExtDataCacheLifetime
Especifica el tiempo, en segundos, que Excel Services Aplicación espera antes de volver a emitir una solicitud de datos externa en abierto o periódica (es decir, automática). Durante este período, es posible que se devuelvan los resultados de la consulta de datos externos anterior de una memoria caché de datos externos. Un valor -1 especifica que nunca se actualice después de la primera consulta.
El tipo debe ser -1, 0 o un número entero entre 1 y 2073600.
El valor predeterminado es 300.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-RequestDurationMax
Especifica la duración máxima en segundos de una sola solicitud en una sesión. Una vez transcurrido ese período, la solicitud supera el tiempo de espera.
El tipo debe ser -1 (sin límite) o un número entero entre 1 y 2073600.
El valor predeterminado es 300.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-RESTExternalDataAllowed
Especifica si las solicitudes de la interfaz de programación de aplicaciones (API) de Transferencia de estado de representación (REST, Representational state transfer) pueden actualizar conexiones de datos externos.
El parámetro RESTExternalDataAllowed no tiene ningún efecto si el parámetro External DataAllowed está establecido en None.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-SessionTimeout
Especifica el tiempo, en segundos, que una sesión permanecerá activa en Excel Services aplicación sin actividad de usuario. El valor predeterminado es 300 segundos. El valor predeterminado es 300. Los valores válidos son:
-1: la sesión nunca caduca
0, la sesión expira al final de una sola solicitud
1 a 2073600: permanece activa de 1 segundo a 24 días
El tipo debe ser -1, 0 o un número entero entre 1 y 2073600.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ShortSessionTimeout
Especifica el tiempo en segundos que tiene un usuario para hacer la interacción inicial con una hoja de cálculo. Una vez transcurrido ese período, si el usuario no está activo, se cierra la sesión. El valor siempre debe ser menor que el de SessionTimeout. Si el valor de ShortSessionTimeout es mayor o igual que SessionTimeout, se devuelve un error. El valor predeterminado es 75.
El tipo debe ser -1 o un número entero entre 1 y 2073600
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UdfsAllowed
Especifica que las funciones definidas por el usuario pueden ser llamadas por libros cargados de la ubicación de confianza especificada en Address.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WarnOnDataRefresh
Especifica que se muestre una advertencia para el usuario al actualizar los datos del libro por primera vez. El valor predeterminado es True.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WhatIf
Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando.
Para obtener más información, escriba el siguiente comando: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WorkbookSizeMax
Especifica el tamaño máximo en megabytes de un libro que se puede cargar. El valor predeterminado es 10.
El tipo debe ser un valor entero entre 1 y 2000.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de