New-SPExcelDataConnectionLibrary
Adiciona uma nova biblioteca de conexão de dados ao Aplicativo de Serviços do Excel.
Sintaxe
Default (Default)
New-SPExcelDataConnectionLibrary
-Address <String>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-WhatIf]
[<CommonParameters>]
Description
O New-SPExcelDataConnectionLibrary cmdlet adiciona uma biblioteca de conexões de dados à lista de bibliotecas de conexões de dados confiáveis para um aplicativo de serviço Web do Aplicativo de Serviços do Excel.
O Aplicativo de Serviços do Excel carrega apenas arquivos de conexão de dados armazenados em uma biblioteca de conexões de dados que esteja na lista de bibliotecas de conexões de dados confiáveis.
As bibliotecas de conexões de dados contêm arquivos de conexão de dados, que contêm todos os recursos que o Aplicativo de Serviços do Excel e o cliente 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 usando informações do arquivo da pasta de trabalho; No entanto, o uso de uma biblioteca de conexões de dados para carregar conexões de dados permite que as conexões de dados sejam 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
$sa = Get-SPExcelServiceApplication
New-SPExcelDataConnectionLibrary -Address "https://portal/site/salesDCL" -Description "This is the DCL where all the connections to the sales data are stored." -ExcelServiceApplication $sa
Este exemplo adiciona uma nova biblioteca de conexões de dados (DCL) e define sua descrição para a lista de bibliotecas de conexões de dados confiáveis que está no aplicativo de serviço Web do aplicativo de Serviços do Excel chamado MyExcelService.
As pastas de trabalho podem usar arquivos de conexão armazenados nessa biblioteca para atualizar dados no aplicativo de serviço Web do Aplicativo de Serviços do Excel.
Parâmetros
-Address
Aplicável: SharePoint Server 2010, SharePoint Server 2013
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 formato https://server_name.
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: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-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 amigável para a biblioteca de conexões de dados.
O tipo deve ser uma string 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 |
-ExcelServiceApplication
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica o aplicativo de serviços da Web do aplicativo de Serviços do Excel que contém o objeto de lista SPExcelDataConnectionLibrary.
O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de um aplicativo de serviço Web do aplicativo de Serviços do Excel no farm (por exemplo, MyExcelService1); ou uma instância de um objeto SPExcelServiceApplication válido.
Propriedades do parâmetro
| Tipo: | SPExcelServiceApplicationPipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| 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 dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.