Articolo
02/17/2017

Set-SPExcelDataProvider

Si applica a: SharePoint Server 2010

Ultima modifica dell'argomento: 2015-03-09

Imposta le proprietà di un provider di dati sicuro per Excel Services in Microsoft SharePoint Server 2010.

Syntax

Set-SPExcelDataProvider [-Identity] <SPExcelDataProviderPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-ProviderId <String>] [-ProviderType <Oledb | Odbc | OdbcDsn>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Il cmdlet Set-SPExcelDataProvider consente di impostare le proprietà di un provider di dati archiviato nell'elenco dei provider di dati attendibili. Excel Services aggiorna una connessione ai dati esterni solo se il provider di dati per quella connessione è presente nell'elenco dei 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 è un'operazione tipica degli 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
Identity	Obbligatorio	Microsoft.Office.Excel.Server.Cmdlet.SPExcelDataProviderPipeBind	Specifica l'oggetto SPExcelDataProvider da aggiornare. Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh, o un'istanza di un oggetto SPExcelDataProvider 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 la descrizione da visualizzare per il provider di dati. Il tipo deve essere una stringa valida, ad esempio “Questo è un provider OLEDB personalizzato”.
ProviderId	Facoltativo	System.String	Specifica il nome del provider di dati. Questo ID deve essere presente nelle stringhe di connessione generate dal provider di dati e deve essere univoco per il tipo di provider di dati. Il tipo deve essere un nome valido di provider, ad esempio OLEDBPersonalizzato.
ProviderType	Facoltativo	Microsoft.Office.Excel.Server.DataProviderType	Specifica il tipo supportato di provider di dati da impostare. Il tipo deve essere uno dei seguenti: OleDb, Odbc o OdbcDsn.
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-SPExcelDataProvider | where {$_.providerID -eq "SQLOLEDB" } | Set-SPExcelDataProvider -Description "This is the Microsoft SQL OLEDB driver (MDAC)"

--------------ESEMPIO 2--------------

$provider = Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataProvider | where {$_.providerID -eq "SQLOLEDB" } 

Set-SPExcelDataProvider $provider -Description "The SQLOLEDB provider description has changed."

$provider | format-table

In questo esempio viene recuperato il provider di dati SQLOLEDB dall'elenco dei provider di dati attendibili dell'applicazione Excel Services denominata MyExcelService, come oggetto, viene aggiunta una nuova descrizione da visualizzare e viene visualizzato l'output del provider in una finestra del prompt dei comandi, formattato come tabella.