Set-SPExcelDataProvider
Define as propriedades de um provedor de dados seguro para o Aplicativo de Serviços do Excel.
Syntax
Set-SPExcelDataProvider
[-Identity] <SPExcelDataProviderPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-ProviderId <String>]
[-ProviderType <DataProviderType>]
[-WhatIf]
[<CommonParameters>]
Description
O Set-SPExcelDataProvider
cmdlet define as propriedades de um provedor de dados que é armazenado na lista de provedores de dados seguros.
Serviços do Excel Aplicativo atualizará as conexões de dados externas somente se o provedor de dados dessa conexão estiver na lista de provedores de dados seguros.
Serviços do Excel Aplicativo inclui um conjunto de provedores de dados comuns nesta lista.
Portanto, o uso de cmdlets para modificar provedores de dados confiáveis é normalmente uma operação de cenários de conexão de dados personalizada.
Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.
Exemplos
---------------------EXEMPLO-----------------------
$provider = Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataProvider | where {$_.ProviderID -eq "SQLOLEDB" }
Set-SPExcelDataProvider $provider -Description "The SQLOLEDB provider description has changed."
$provider | format-table
Este exemplo recupera o provedor de dados SQLOLEDB da lista de provedores de dados seguros que está no aplicativo de serviço Web de aplicativo Serviços do Excel chamado MyExcelService, como um objeto, adiciona uma nova descrição de exibição e exibe a saída do provedor em uma janela prompt de comando, formatada como uma tabela.
Parâmetros
-AssignmentCollection
Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.
Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global.
Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment
, pode ocorrer um cenário de memória insuficiente.
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
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: 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
Especifica uma descrição de exibição para o provedor de dados.
O tipo deve ser uma cadeia de caracteres válida; por exemplo, “Este é um provedor OLEDB personalizado”.
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
Especifica o objeto SPExcelDataProvider a ser atualizado.
O tipo deve ser um GUID válido, na forma 12345678-90ab-cdef-1234-567890bcdefgh, ou uma instância de um objeto SPExcelDataProvider válido.
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
Especifica o nome do provedor de dados. Essa ID deve estar presente nas cadeias de conexão geradas por esse provedor de dados e a ID deve ser exclusiva para o tipo de provedor de dados.
O tipo deve ser um nome válido de provedor; por exemplo, CustomOLEDB.
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
Especifica o tipo com suporte do provedor de dados a ser definido.
O tipo deve ser um dos seguintes: OleDb, Odbc ou 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
Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando.
Para saber mais, digite o seguinte comando: 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 |