Compartilhar via


Set-SPExcelDataProvider

Define as propriedades de um provedor de dados seguro para o Aplicativo de Serviços do Excel.

Sintaxe

Default (Padrão)

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 fornecedor de dados armazenado na lista de fornecedores de dados seguros. Serviços do Excel a Aplicação atualiza as ligações de dados externos apenas se o fornecedor de dados dessa ligação estiver na lista de fornecedores de dados seguros. Serviços do Excel Aplicação incluem um conjunto de fornecedores 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 obtém o fornecedor de dados SQLOLEDB a partir da lista de fornecedores de dados seguros que se encontra na aplicação do serviço Web da Aplicação Serviços do Excel denominada MyExcelService, como um objeto, adiciona uma nova descrição de apresentação e, em seguida, apresenta a saída do fornecedor numa janela da Linha de Comandos, formatada como uma tabela.

Parâmetros

-AssignmentCollection

Aplicável: SharePoint Server 2010, SharePoint Server 2013

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.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Description

Aplicável: SharePoint Server 2010, SharePoint Server 2013

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”.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: SharePoint Server 2010, SharePoint Server 2013

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.

Propriedades do parâmetro

Tipo:SPExcelDataProviderPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProviderId

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o nome do provedor de dados. Este ID deve estar presente nas cadeias de ligação geradas por este fornecedor de dados e o ID tem de ser exclusivo para o tipo de fornecedor de dados.

O tipo deve ser um nome válido de provedor; por exemplo, CustomOLEDB.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProviderType

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o tipo com suporte do provedor de dados a ser definido.

O tipo deve ser um dos seguintes: OleDb, Odbc ou OdbcDsn.

Propriedades do parâmetro

Tipo:DataProviderType
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: SharePoint Server 2010, SharePoint Server 2013

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.