Set-SPExcelDataProvider

Riferimento

Modulo:: SharePointServer

Si applica a:: SharePoint Server 2010, SharePoint Server 2013

Imposta le proprietà di un provider di dati sicuro per l'applicazione Excel Services.

Sintassi

Set-SPExcelDataProvider
   [-Identity] <SPExcelDataProviderPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Description <String>]
   [-ProviderId <String>]
   [-ProviderType <DataProviderType>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Il Set-SPExcelDataProvider cmdlet imposta le proprietà di un provider di dati archiviato nell'elenco dei provider di dati sicuri. Excel Services'applicazione aggiorna le connessioni dati esterne solo se il provider di dati per tale connessione è incluso nell'elenco dei provider di dati sicuri. Excel Services'applicazione include un set di provider di dati comuni in questo elenco. Pertanto, l'uso di cmdlet per modificare i provider di dati sicuri è in genere un'operazione di scenari di connessione dati personalizzati.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

--------------------ESEMPIO---------------------

$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 sicuri presenti nell'applicazione del servizio Web applicazione Excel Services denominata MyExcelService, come oggetto , viene aggiunta una nuova descrizione di visualizzazione e quindi viene visualizzato l'output del provider in una finestra del prompt dei comandi, formattata come tabella.

Parametri

-AssignmentCollection

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.

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.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013

-Description

Specifica la descrizione da visualizzare per il provider di dati.

Il tipo deve essere una stringa valida, ad esempio “Questo è un provider OLEDB personalizzato”.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013

-Identity

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.

Type:	SPExcelDataProviderPipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013

-ProviderId

Specifica il nome del provider di dati. Questo ID deve essere presente nelle stringhe di connessione generate da questo provider di dati e l'ID deve essere univoco per il tipo di provider di dati.

Il tipo deve essere un nome valido di provider, ad esempio OLEDBPersonalizzato.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013

-ProviderType

Specifica il tipo supportato di provider di dati da impostare.

Il tipo deve essere uno dei seguenti valori: OleDb, Odbc o OdbcDsn.

Type:	DataProviderType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013

-WhatIf

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013