Compartir a través de


New-SPExcelFileLocation

Agrega una nueva ubicación de confianza a la aplicación de Servicios de Excel.

Sintaxis

Default (Es el valor predeterminado).

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:$false

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.

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

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Address

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AssignmentCollection

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:SPAssignmentCollection
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AutomaticVolatileFunctionCacheLifetime

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ChartAndImageSizeMax

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ChartRenderDurationMax

Aplicable: SharePoint Server 2010, SharePoint Server 2013

{{Fill ChartRenderDurationMax Description}}

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ConcurrentDataRequestsPerSessionMax

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultWorkbookCalcMode

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:DefaultWorkbookCalcMode
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Description

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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".

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DisplayGranularExtDataErrors

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Muestra mensajes de error granulares para los archivos de esta ubicación con error en los datos externos.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ExcelServiceApplication

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:SPExcelServiceApplicationPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ExternalDataAllowed

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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

Propiedades del parámetro

Tipo:AllowExternalData
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IncludeChildren

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-LocationType

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:LocationType
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ManualExtDataCacheLifetime

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-NewWorkbookSessionTimeout

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PeriodicExtDataCacheLifetime

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RequestDurationMax

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RESTExternalDataAllowed

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SessionTimeout

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ShortSessionTimeout

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UdfsAllowed

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WarnOnDataRefresh

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica que se muestre una advertencia para el usuario al actualizar los datos del libro por primera vez. El valor predeterminado es True.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WorkbookSizeMax

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.