Compartilhar via

Set-SPExcelDataConnectionLibrary

Módulo:
SharePointServer module

Define as propriedades de uma biblioteca de conexões de dados do Aplicativo de Serviços do Excel.

Sintaxe

Default (Padrão) 

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 a partir da qual Serviços do Excel a Aplicação carrega ficheiros de ligação de dados. Serviços do Excel a Aplicação carrega ficheiros de ligação de dados apenas se estiverem armazenados numa biblioteca de ligação de dados que esteja na lista de bibliotecas de ligação de dados fidedignas. Essas bibliotecas constituem um tipo de lista no ExcelServicesApp que contém os arquivos de conexão de dados. Estes ficheiros contêm tudo o que Serviços do Excel Aplicação e o cliente do Excel necessitam para ligar a uma origem 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 apresentação para a entrada https://portal/site/salesDCL na lista de bibliotecas de ligação de dados fidedignas (DCLs) que se encontra na aplicação de serviço Web da Aplicação Serviços do Excel denominada 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 ligação de dados para https://portal/site/salesDCL a entrada https://portal/test/site/salesDCL na lista de bibliotecas de ligação de dados fidedignas, que se encontra na aplicação do serviço Web da Aplicação Serviços do Excel denominada MyExcelService.

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 tem de ser um URL válido, no formulário 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:False
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 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”.

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 Serviços do Excel aplicação do serviço Web da Aplicação que contém o objeto de lista SPExcelDataConnectionLibrary.

O tipo tem de ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de uma aplicação de serviço Web da Aplicação 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

-Identity

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o objeto DataConnectionLibrary a ser atualizado.

O tipo tem de ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de uma biblioteca de ligação de dados (por exemplo, DataConnectionLib1); um URL válido, no formulário https://server_name; ou uma instância de um objeto SPExcelDCL válido.

Propriedades do parâmetro

Tipo:SPExcelDCLPipeBind
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

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