Set-SPExcelDataConnectionLibrary
Define as propriedades de uma biblioteca de conexões de dados do Aplicativo de Serviços do Excel.
Syntax
Set-SPExcelDataConnectionLibrary
[-Identity] <SPExcelDCLPipeBind>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-Address <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-WhatIf]
[<CommonParameters>]
Description
O Set-SPExcelDataConnectionLibrary
cmdlet define as propriedades de uma biblioteca da qual Serviços do Excel Aplicativo carrega arquivos de conexão de dados.
Serviços do Excel Aplicativo carrega arquivos de conexão de dados somente se eles forem armazenados em uma biblioteca de conexão de dados que esteja na lista de bibliotecas de conexão de dados confiáveis.
Essas bibliotecas constituem um tipo de lista no ExcelServicesApp que contém os arquivos de conexão de dados.
Esses arquivos contêm tudo o que Serviços do Excel Aplicativo e o cliente do Excel exigem para se conectar a uma fonte de dados externa.
As bibliotecas de conexões de dados permitem que você reutilize e compartilhe conexões de dados.
As conexões de dados podem ser carregadas com o uso das informações do arquivo da pasta de trabalho.
Porém, a utilização de uma biblioteca para carregar conexões de dados oferece uma camada adicional para as conexões de dados, de forma que elas possam ser gerenciadas separadamente das pastas de trabalho.
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 1----------------
Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataConnectionLibrary | where {$_.address -eq "https://portal/site/salesDCL" } | Set-SPExcelDataConnectionLibrary -Description "This is the DCL where all the connections to the sales data are stored
Este exemplo define uma descrição de exibição para a entrada https://portal/site/salesDCL na lista de DCLs (bibliotecas de conexão de dados confiáveis) que está no aplicativo de serviço Web de aplicativo Serviços do Excel chamado MyExcelService.
------------EXEMPLO 2----------------
Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataConnectionLibrary | where {$_.address -eq "https://portal/site/salesDCL" } | Set-SPExcelDataConnectionLibrary -Address "https://portal/site/salesDCL
Este exemplo atualiza o endereço da biblioteca de conexões de dados para a entrada https://portal/test/site/salesDCLhttps://portal/site/salesDCL na lista de bibliotecas de conexão de dados confiáveis, que está no aplicativo de serviço Web de aplicativo Serviços do Excel chamado MyExcelService.
Parâmetros
-Address
Especifica o endereço da biblioteca de conexões de dados. O endereço deve ser exclusivo na lista de bibliotecas de conexões de dados confiáveis.
O tipo deve ser uma URL válida, no formulário https://server_name.
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 |
-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 amigável para a biblioteca de conexões de dados.
O tipo deve ser uma cadeia de caracteres válida; por exemplo, “Esta é a biblioteca de conexões de dados na qual são armazenadas todas as conexões com os dados de vendas”.
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 |
-ExcelServiceApplication
Especifica o aplicativo de serviço Web de aplicativo Serviços do Excel que contém o objeto de lista SPExcelDataConnectionLibrary.
O tipo deve ser um GUID válido, no formulário 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de um aplicativo de serviço Web de aplicativo Serviços do Excel no farm (por exemplo, MyExcelService1); ou uma instância de um objeto SPExcelServiceApplication válido.
Type: | SPExcelServiceApplicationPipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Identity
Especifica o objeto DataConnectionLibrary a ser atualizado.
O tipo deve ser um GUID válido, no formulário 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de uma biblioteca de conexão de dados (por exemplo, DataConnectionLib1); uma URL válida, no formulário https://server_name; ou uma instância de um objeto SPExcelDCL válido.
Type: | SPExcelDCLPipeBind |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |