Set-SPExcelDataConnectionLibrary
Si applica a: SharePoint Server 2010
Ultima modifica dell'argomento: 2015-03-09
Imposta le proprietà di una raccolta connessioni dati per Excel Services in Microsoft SharePoint Server 2010.
Syntax
Set-SPExcelDataConnectionLibrary [-Identity] <SPExcelDCLPipeBind> -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-Address <String>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il cmdlet Set-SPExcelDataConnectionLibrary consente di impostare le proprietà di una raccolta da cui Excel Services carica i file di connessione dati. Excel Services carica i file di connessione dati solo se sono memorizzati in una raccolta di connessioni dati presente nell'elenco delle raccolte di connessioni dati attendibili. Le raccolte di connessioni dati costituiscono una sorta di elenco in Microsoft SharePoint Server 2010 contenente i file di connessione dati. Tali file contengono tutti gli elementi necessari a Excel Services e al client Microsoft Excel per eseguire la connessione a un'origine dati esterna. Le raccolte di connessioni dati consentono di riutilizzare e condividere le connessioni dati. Le connessioni dati possono essere caricate utilizzando le informazioni contenute nei file delle cartelle di lavoro. Tuttavia, se si utilizza una raccolta di connessioni dati per caricare le connessioni dati, si dispone di un ulteriore livello per le connessioni dati, che in questo modo potranno essere gestite separatamente rispetto alle cartelle di lavoro.
Per le autorizzazioni e le informazioni più aggiornate su Windows PowerShell per SharePoint Server 2010, vedere i relativi articoli in TechNet all'indirizzo https://go.microsoft.com/fwlink/?linkid=163183\&clcid=0x410
Parameters
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Microsoft.Office.Excel.Server.Cmdlet.SPExcelDCLPipeBind |
Specifica l'oggetto DataConnectionLibrary da aggiornare. Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di raccolta di connessioni dati (ad esempio, RaccoltaConnessioniDati1), un URL valido, nel formato http://server_name o un'istanza di oggetto SPExcelDCL valido. |
ExcelServiceApplication |
Obbligatorio |
Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind |
Specifica l'applicazione Excel Services che contiene l'oggetto elenco SPExcelDataConnectionLibrary. Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un'applicazione Excel Services presente nella farm, ad esempio ServizioExcel1, o un'istanza di un oggetto SPExcelServiceApplication valido. |
Address |
Facoltativo |
System.String |
Specifica l'indirizzo della raccolta di connessioni dati. L'indirizzo deve essere univoco nell'elenco delle raccolte di connessioni dati attendibili. Il tipo deve essere un URL valido, nel formato http://server_name. |
AssignmentCollection |
Facoltativo |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global. Nota Quando viene utilizzato il parametro Global tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente. |
Confirm |
Facoltativo |
System.Management.Automation.SwitchParameter |
Visualizza una richiesta di conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters |
Description |
Facoltativo |
System.String |
Specifica una descrizione per la raccolta di connessioni dati. Il tipo deve essere una stringa valida, ad esempio "Questa è la raccolta connessioni dati in cui sono archiviate tutte le connessioni ai dati sulle vendite". |
WhatIf |
Facoltativo |
System.Management.Automation.SwitchParameter |
Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters |
Tipi di input
Tipi restituiti
Example
--------------ESEMPIO 1--------------
Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataConnectionLibrary | where {$_.address -eq "http://portal/site/salesDCL" } | Set-SPExcelDataConnectionLibrary -Description "This is the DCL where all the connections to the sales data are stored
In questo esempio viene impostata una descrizione da visualizzare per la voce http://portal/site/salesDCL dell'elenco delle raccolte di connessioni dati attendibili (DCL) presente nell'applicazione Excel Services denominata MyExcelService.
--------------ESEMPIO 2--------------
Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataConnectionLibrary | where {$_.address -eq "http://portal/site/salesDCL" } | Set-SPExcelDataConnectionLibrary -Address "http://portal/site/salesDCL
In questo esempio viene aggiornato l'indirizzo della raccolta di connessioni dati per la voce http://portal/test/site/salesDCL a http://portal/site/salesDCL nell'elenco delle raccolte di connessioni dati attendibili, presente nell'applicazione Excel Services denominata MyExcelService.