New-SPExcelDataProvider
Si applica a: SharePoint Server 2010
Ultima modifica dell'argomento: 2015-03-09
Aggiunge un nuovo provider di dati sicuro a Excel Services in Microsoft SharePoint Server 2010.
Syntax
New-SPExcelDataProvider -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> -ProviderId <String> -ProviderType <Oledb | Odbc | OdbcDsn> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il cmdlet New-SPExcelDataProvider aggiunge un provider di dati all'elenco di provider di dati attendibili in un'applicazione Excel Services. Excel Services aggiorna una connessione ai dati esterni solo se il provider di dati per la connessione è presente nell'elenco di provider di dati attendibili. Excel Services include nell'elenco alcuni provider di dati comuni, quindi l'uso dei cmdlet per modificare i provider di dati sicuri di solito è necessario solo negli scenari di connessione dati personalizzati.
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 |
|---|---|---|---|
ExcelServiceApplication |
Obbligatorio |
Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind |
Specifica l'applicazione Excel Services che contiene l'oggetto elenco SPExcelDataProvider. 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. |
ProviderId |
Obbligatorio |
System.String |
Specifica il nome del provider. Questo ID deve essere presente nelle stringhe di connessione generate dal provider e deve essere univoco per il tipo di provider. Il tipo deve essere un nome valido di provider, ad esempio OLEDBPersonalizzato. |
ProviderType |
Obbligatorio |
Microsoft.Office.Excel.Server.DataProviderType |
Specifica il tipo supportato di provider di dati da aggiungere all'elenco dei provider attendibili. Il tipo deve essere uno dei seguenti valori: OleDb, Odbc o OdbcDsn. |
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 del nuovo provider di 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 1--------------
Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelDataProvider -providerID "CustomOLEDB" -ProviderType OleDb -description "This is a custom OLEDB provider"
In questo esempio viene aggiunto un nuovo provider di dati OLEDB personalizzato all'elenco dei provider di dati attendibili per l'applicazione Excel Services denominata MyExcelService.
--------------ESEMPIO 2--------------
Get-SPExcelServiceApplication | New-SPExcelDataProvider -providerID "CustomOLEDB" -ProviderType OleDb -description "This is a custom OLEDB provider"
In questo esempio viene aggiunto un nuovo provider di dati OLEDB personalizzato all'elenco dei provider di dati attendibili per tutte le applicazioni Excel Services della farm.