New-SPExcelFileLocation
Agrega una nueva ubicación de confianza a la aplicación de Servicios de Excel.
Syntax
New-SPExcelFileLocation
-Address <String>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AbortOnRefreshOnOpenFail]
[-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 New-SPExcelFileLocation cmdlet agrega una nueva ubicación a la lista de ubicaciones de archivos de confianza en una aplicación de servicio web de aplicación Excel Services.
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 que usa 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.
La coincidencia más larga tiene prioridad. Por ejemplo, si https://portal/site/ y https://portal/site/subsite son ubicaciones de confianza y carga un libro desde el subsitio, la aplicación usa las propiedades de la ubicación de confianza del subsitio porque tiene la dirección coincidente más larga.
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-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address "https://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$falseEn este ejemplo se agrega una nueva ubicación de archivo de confianza a la lista de ubicaciones de archivos de confianza que se encuentra en la aplicación de servicio web de aplicación Excel Services denominada MyExcelService.
Este ejemplo permite que los libros se carguen desde cualquier elemento secundario o subcarpeta que comience por https://myPortal/myTeam. Todos los libros cargados desde esta ubicación deben tener un tamaño inferior a 50 megabytes (MB). Los libros pueden actualizar datos externos usando conexiones incrustadas en el archivo del libro o almacenadas en una biblioteca de conexiones de datos. No se mostrará un mensaje de advertencia indicando que el libro está intentando actualizar datos externos.
------------------EJEMPLO 2------------------
Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address https://myPortal/myTeam/managers -locationType SharePoint -description "This is the manager's subsite for myTeam."En este ejemplo se agrega una nueva ubicación de archivo de confianza a la lista de ubicaciones de archivos de confianza que se encuentra en la aplicación de servicio web de aplicación Excel Services denominada MyExcelService con una dirección y una descripción dadas.
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 de productos y tecnologías de SharePoint para el archivo.
- El archivo de libro tiene conexiones de datos que se actualizan automáticamente cuando se abre el archivo de aplicación de Excel Services.
| 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
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: | True |
| 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 Calcula una vez cuando se carga el libro.
0 Calcula siempre.
De 1 a 2073600 cachés de 1 segundo a 24 días. El valor de número entero predeterminado es 300.
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
{{Fill ChartRenderDurationMax Description}}
| 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. 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. None 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 cualquiera de los siguientes ajustes:
Ninguno
Dcl
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 |
-IncludeChildren
Indica que las direcciones URL subordinadas, directorios y bibliotecas son de confianza. Por ejemplo, si la ubicación del archivo de confianza es https://portal e IncludeChildren es true, https://portal/subSite también es de confianza, al igual que cualquier dirección URL subordinada a 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
Especifica el tipo de ubicación. El tipo de ubicación indica cómo Excel Services Application recupera los archivos de la ubicación especificada en Dirección. El ajuste predeterminado es el tipo SharePoint. 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 emite una solicitud de datos externa manual o iniciada por el usuario. 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. El valor predeterminado es 300.
Los valores válidos son todos los siguientes elementos:
-1: no actualizar nunca después de la primera consulta. 1 a 2073600: almacenar en la memoria caché de 1 segundo a 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 |
-NewWorkbookSessionTimeout
Especifica el tiempo, en segundos, que una sesión de un nuevo libro, sin guardar, permanece activa en Excel Services Aplicación sin actividad de usuario. Valores válidos:
-1 La sesión nunca expira.
0 La sesión expira al final de una sola solicitud.
De 1 a 2073600 permanece activo de 1 segundo a 24 días. El valor predeterminado es 1800.
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 emite 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 de -1 especifica que nunca se actualice después de la primera consulta. El valor predeterminado es 300.
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 |
-RequestDurationMax
Especifica la duración máxima, en segundos, para una única solicitud en una sesión. Una vez transcurrido este tiempo, se agota el tiempo de espera de la solicitud. El valor predeterminado es 300.
El tipo debe ser -1 (sin límite) 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 |
-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 efecto si el parámetro ExternalDataAllowed está ajustado 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 permanece activa en Excel Services aplicación sin actividad de usuario. Valores válidos:
-1 La sesión nunca expira.
La sesión 0 expira al final de una sola solicitud.
De 1 a 2073600 permanece activo de 1 segundo a 24 días. El valor predeterminado es 300.
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.
El valor predeterminado es False.
| 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