New-SPExcelDataConnectionLibrary
Si applica a: SharePoint Server 2010
Ultima modifica dell'argomento: 2015-03-09
Aggiunge una nuova raccolta connessioni dati a Excel Services in Microsoft SharePoint Server 2010.
Syntax
New-SPExcelDataConnectionLibrary -Address <String> -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il cmdlet New-SPExcelDataConnectionLibrary consente di aggiungere una raccolta di connessioni dati all'elenco delle raccolte di connessioni dati attendibili per un'applicazione Excel Services. Excel Services carica solo i file di connessione dati memorizzati in una raccolta di connessioni dati presente nell'elenco delle raccolte di connessioni dati attendibili. La raccolta di connessioni dati è costituita da un elenco di Microsoft SharePoint Server 2010 contenente file di connessione dati. Tali file contengono tutte le risorse richieste da Excel Services e dal client Microsoft Excel per connettersi a un'origine dati esterna. Le raccolte di connessioni dati consentono di riutilizzare e condividere le connessioni dati. Per caricare le connessioni dati è possibile utilizzare le informazioni contenute nel file della cartella di lavoro, tuttavia se si utilizza una raccolta di connessioni dati sarà possibile gestire le connessioni separatamente dalle 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 |
|---|---|---|---|
Address |
Obbligatorio |
System.String |
Specifica l'indirizzo della raccolta di connessioni dati di SharePoint Server 2010. 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. |
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. |
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 “Questo è un provider OLEDB personalizzato”. |
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----------------------
Get-SPExcelServiceApplication -Identity "MyExcelService" | New-SPExcelDataConnectionLibrary -address "http://portal/site/salesDCL" -description "This is the DCL where all the connections to the sales data are stored."
In questo esempio viene aggiunta una nuova raccolta di connessioni dati (DCL) e viene impostata la relativa descrizione nell'elenco delle raccolte di connessioni dati attendibili dell'applicazione Excel Services denominata MyExcelService.
I file di connessione memorizzati in tale raccolta possono essere utilizzati dalle cartelle di lavoro per aggiornare i dati nell'applicazione Excel Services.