Set-SPExcelDataConnectionLibrary
Establece las propiedades de una biblioteca de conexiones de datos para la aplicación de Servicios de Excel.
Sintaxis
Default (Es el valor predeterminado).
Set-SPExcelDataConnectionLibrary
[-Identity] <SPExcelDCLPipeBind>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-Address <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-WhatIf]
[<CommonParameters>]
Description
El Set-SPExcelDataConnectionLibrary cmdlet establece las propiedades de una biblioteca desde la que Excel Services Application carga los archivos de conexión de datos.
Excel Services Aplicación carga los archivos de conexión de datos solo si se almacenan en una biblioteca de conexiones de datos que se encuentra en la lista de bibliotecas de conexión de datos de confianza.
DLas bibliotecas de conexiones de datos constituyen un tipo de lista que contiene archivos de conexión de datos.
Estos archivos contienen todo lo que Excel Services Application y el cliente de Excel necesitan para conectarse a un origen de datos externo.
Las bibliotecas de conexiones de datos permiten volver a usar y compartir conexiones de datos.
Las conexiones de datos se pueden cargar usando información del archivo del libro.
Sin embargo, al usar una biblioteca de conexiones de datos para cargar conexiones de datos se genera una capa adicional para las mismas de modo que se puedan administrar independientemente de los libros.
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" | Get-SPExcelDataConnectionLibrary | where {$_.address -eq "https://portal/site/salesDCL" } | Set-SPExcelDataConnectionLibrary -Description "This is the DCL where all the connections to the sales data are stored
En este ejemplo se establece una descripción para mostrar para la entrada https://portal/site/salesDCL de la lista de bibliotecas de conexión de datos de confianza (DCL) que se encuentra en la aplicación de servicio web de aplicación Excel Services denominada MyExcelService.
EJEMPLO 2
Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataConnectionLibrary | where {$_.address -eq "https://portal/site/salesDCL" } | Set-SPExcelDataConnectionLibrary -Address "https://portal/site/salesDCL
En este ejemplo se actualiza la dirección de la biblioteca de conexiones de datos para la entrada https://portal/test/site/salesDCL a https://portal/site/salesDCL en la lista de bibliotecas de conexión de datos de confianza, que se encuentra en la aplicación de servicio web de aplicación Excel Services denominada MyExcelService.
Parámetros
-Address
Aplicable: SharePoint Server 2010, SharePoint Server 2013
Especifica la dirección de la biblioteca de conexiones de datos. La dirección debe ser única en la lista de biblioteca de conexiones de datos de confianza.
El tipo debe ser una dirección URL válida, en el formulario https://server_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: | False |
| 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 |
-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 |
-Description
Aplicable: SharePoint Server 2010, SharePoint Server 2013
Especifica una descripción simplificada de la biblioteca de conexiones de datos.
El tipo debe ser una cadena válida; por ejemplo, “Ésta es la biblioteca de conexiones de datos donde se almacenan todas las conexiones a los datos de ventas”.
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 |
-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 SPExcelDataConnectionLibrary.
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 |
-Identity
Aplicable: SharePoint Server 2010, SharePoint Server 2013
Especifica el objeto DataConnectionLibrary para actualizar.
El tipo debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh; un nombre válido de una biblioteca de conexiones de datos (por ejemplo, DataConnectionLib1); una dirección URL válida, con el formato https://server_name; o una instancia de un objeto SPExcelDCL válido.
Propiedades del parámetro
| Tipo: | SPExcelDCLPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| 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 |
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.