Set-SPExcelFileLocation

Define as propriedades de um local de arquivo confiável do Aplicativo de Serviços do Excel.

Sintaxe

Default (Default)

Set-SPExcelFileLocation
    [-Identity] <SPExcelFileLocationPipeBind>
    -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
    [-AbortOnRefreshOnOpenFail]
    [-Address <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-AutomaticVolatileFunctionCacheLifetime <Int32>]
    [-ChartAndImageSizeMax <Int32>]
    [-ConcurrentDataRequestsPerSessionMax <Int32>]
    [-Confirm]
    [-DefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
    [-Description <String>]
    [-DisplayGranularExtDataErrors]
    [-ExternalDataAllowed <AllowExternalData>]
    [-IncludeChildren]
    [-LocationType <LocationType>]
    [-ManualExtDataCacheLifetime <Int32>]
    [-NewWorkbookSessionTimeout <Int32>]
    [-PeriodicExtDataCacheLifetime <Int32>]
    [-RequestDurationMax <Int32>]
    [-RESTExternalDataAllowed]
    [-SessionTimeout <Int32>]
    [-ShortSessionTimeout <Int32>]
    [-UdfsAllowed]
    [-WarnOnDataRefresh]
    [-WhatIf]
    [-WorkbookSizeMax <Int32>]
    [-ChartRenderDurationMax <Int32>]
    [<CommonParameters>]

Description

O Set-SPExcelFileLocation cmdlet define as propriedades de um local do qual o Aplicativo de Serviços do Excel carrega pastas de trabalho. O Aplicativo de Serviços do Serviços do Excel carrega apenas pastas de trabalho armazenadas em um local de arquivo confiável. As propriedades de locais de arquivos confiáveis controlam como as pastas de trabalho podem ser usadas quando são carregadas no Aplicativo de Serviços do Excel. O Aplicativo de Serviços do Excel sempre impõe as propriedades definidas pelo local de arquivo confiável do qual uma pasta de trabalho foi carregada. As propriedades que são usadas pelo local de arquivo confiável são determinadas pela comparação do caminho do arquivo para a pasta de trabalho com o parâmetro Address do local de arquivo confiável.

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-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed Dcl

Este exemplo obtém todos os locais de arquivo confiáveis para o aplicativo de serviços Web do aplicativo de Serviços do Excel chamado Meu Serviço do Excel que permite que conexões de dados sejam carregadas de arquivos de pasta de trabalho e especifica que os locais devem usar uma biblioteca de conexões de dados para carregar conexões de dados.

EXEMPLO 2

Get-SPExcelServiceApplication | Get-SPExcelFileLocation | where {$_.Address -eq "https://"} | Set-SPExcelFileLocation -Description "This is the default trusted file location for Excel Services Application. It allows any file from anywhere in SharePoint to load."

Este exemplo altera a descrição do local do arquivo padrão para cada aplicativo de serviço Web do aplicativo de Serviços do Excel no farm.

Parâmetros

-AbortOnRefreshOnOpenFail

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica que o carregamento de um arquivo de Aplicativo de Serviços do Excel do Excel falhará automaticamente se uma operação de atualização automática de dados falhar quando o arquivo for aberto. A carga só falhará se ocorrerem as seguintes condições:

-- O usuário tem permissões somente leitura para o arquivo do Aplicativo de Serviços do Excel. -- O arquivo da pasta de trabalho tem conexões de dados que são automaticamente atualizadas quando o arquivo do Excel é aberto.

Propriedades do parâmetro

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

-Address

Aplicável: SharePoint Server 2010, SharePoint Server 2013

System.String

Especifica uma pasta da Web ou um diretório de arquivos a partir do qual o Aplicativo de Serviços do Excel pode carregar pastas de trabalho.

O tipo deve ser uma URL válida, no formulário https://myPortal/myTeam; ou um caminho UNC válido no formulário, \\server_name\folder_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

-AutomaticVolatileFunctionCacheLifetime

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o tempo máximo, em segundos, que um valor calculado para uma função volátil é armazenado em cache para recálculos automáticos. Os valores válidos incluem:

-1, calcula uma vez quando a pasta de trabalho é carregada

0, sempre calcula

1 a 2073600, permanece no cache de 1 segundo a 24 dias

O tipo deve ser os inteiros -1 ou 0 ou um inteiro no intervalo de 1 a 2073600.

Propriedades do parâmetro

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

-ChartAndImageSizeMax

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o tamanho máximo, em megabytes, de um gráfico ou de uma imagem que pode ser aberta. O valor padrão é 1.

O tipo deve ser um inteiro válido maior que 0.

Propriedades do parâmetro

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

-ChartRenderDurationMax

Aplicável: SharePoint Server 2010, SharePoint Server 2013

O tempo máximo (em segundos) gasto na renderização de um único gráfico.

Valores válidos: -1 (sem limite); de 1 a 2073600 (24 dias).

Propriedades do parâmetro

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

-ConcurrentDataRequestsPerSessionMax

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o número máximo de solicitações simultâneas por dados externos permitidas em cada sessão. Se uma sessão precisar emitir um número maior de solicitações, as solicitações adicionais terão que ser colocadas em fila. O escopo dessa configuração é o servidor lógico. O valor padrão é 5.

O tipo deve ser um número inteiro positivo.

Propriedades do parâmetro

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

-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

-DefaultWorkbookCalcMode

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o modo de cálculo das pastas de trabalho. Todas as configurações, exceto a configuração File substituem as configurações da pasta de trabalho. Se esse parâmetro for alterado, ele será aplicado a todas as novas sessões no Aplicativo de Serviços do Excel quando o cache de propriedades do ConfigDB for atualizado. A configuração padrão é File.

O tipo deve ser um dos seguintes: File, Manual, Auto ou AutoDataTables.

Propriedades do parâmetro

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

-Description

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica uma descrição amigável para o novo local do arquivo.

O tipo deve ser uma cadeia de caracteres válida; por exemplo, este é o local de arquivo dos relatórios de vendas mensais.

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

-DisplayGranularExtDataErrors

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Exibe mensagens de erro granulares para falhas de dados externos de arquivos neste local.

Propriedades do parâmetro

Tipo:SwitchParameter
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ço Web do Aplicativo de Serviços do Excel que contém o objeto de lista SPExcelFileLocation.

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

-ExternalDataAllowed

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o tipo de acesso a dados externos permitido para pastas de trabalho: Nenhum Especifica que a atualização de dados está desabilitada. Dcl especifica que os dados serão atualizados somente quando usarem um arquivo de conexão em uma biblioteca de conexões de dados confiável. DclandEmbedded especifica que uma biblioteca de conexões de dados pode ser usada, mas não é obrigatório. O escopo dessa configuração é o local confiável.

O valor padrão é None.

O tipo deve ser um dos seguintes: None, Dcl ou DclAndEmbedded.

Propriedades do parâmetro

Tipo:AllowExternalData
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 FileLocation a ser atualizado. O nome deve ser exclusivo na lista de locais de arquivo.

O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; uma cadeia de caracteres válida que identifica o local do arquivo, no formato https://myPortal/myTeam; uma cadeia de caracteres válida que identifica o caminho, no formato C:\folder_name; ou uma instância de um objeto SPExcelFileLocation válido.

Propriedades do parâmetro

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

-IncludeChildren

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Indica que as URLs, os diretórios e as bibliotecas subordinados são confiáveis. Por exemplo, se o local confiável do arquivo for https://portal, e IncludeChildren for verdadeiro, então https://portal/subSite também é confiável, assim como qualquer subURL na URL especificada em Endereço.

Propriedades do parâmetro

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

-LocationType

Aplicável: SharePoint Server 2010, SharePoint Server 2013

O tipo de local. LocationType indica como o Aplicativo de Serviços do Excel recupera arquivos do local especificado em Endereço. O valor padrão é SharePoint.

O tipo deve ser um dos seguintes: SharePoint, UNC ou HTTP.

Propriedades do parâmetro

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

-ManualExtDataCacheLifetime

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o tempo, em segundos, que o Aplicativo de Serviços do Excel aguarda antes de reemitir uma solicitação de dados externos manual ou iniciada pelo usuário. Durante esse período, os resultados da solicitação de dados externos anterior podem ser retornados de um cache de dados externos.

Os valores válidos são:

-1 Nunca atualizar após a primeira consulta

1 a 2073600 caches de 1 segundo a 24 dias.

O valor padrão é 300.

Propriedades do parâmetro

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

-NewWorkbookSessionTimeout

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o tempo, em segundos, que uma sessão de uma nova pasta de trabalho não salva permanecerá ativa no Aplicativo de Serviços do Excel sem nenhuma atividade do usuário. O valor padrão é 1800. Os valores válidos incluem:

-1, a sessão nunca expira

0, a sessão expira ao final de uma única solicitação

1 a 2073600, permanecem ativos de 1 segundo a 24 dias.

O tipo deve ser -1 ou um inteiro no intervalo de 1 a 2073600.

Propriedades do parâmetro

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

-PeriodicExtDataCacheLifetime

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o tempo, em segundos, que o Aplicativo de Serviços do Excel aguarda antes de reemitir uma solicitação de dados externos ao abrir ou periódica (ou seja, automática). Durante esse período, os resultados da solicitação de dados externos anterior podem ser retornados de um cache de dados externos. Um valor -1 especifica que nunca será atualizado após a primeira consulta.

O tipo deve ser -1 ou um inteiro no intervalo de 1 a 2073600.

O valor padrão é 300.

Propriedades do parâmetro

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

-RequestDurationMax

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica a duração máxima, em segundos, de uma única solicitação em uma sessão. Após esse período, o tempo limite da solicitação se esgota.

O tipo deve ser -1 (sem limite) ou um inteiro no intervalo de 1 a 2073600.

O valor padrão é 300.

Propriedades do parâmetro

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

-RESTExternalDataAllowed

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica se as solicitações da API (interface de programação de aplicativo) do REST (Representational State Transfer) são permitidas para atualizar conexões de dados externos.

O parâmetro RESTExternalDataAllowed não terá efeito se o parâmetro External DataAllowed estiver definido como None.

Propriedades do parâmetro

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

-SessionTimeout

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o tempo, em segundos, que uma sessão permanecerá ativa no Aplicativo de Serviços do Excel sem nenhuma atividade do usuário. O padrão é 300 segundos. O valor padrão é 300. Os valores válidos incluem:

-1, a sessão nunca expira

0, a sessão expira ao final de uma única solicitação

1 a 2073600, permanece ativo de 1 segundo a 24 dias

O tipo deve ser -1 ou um inteiro no intervalo de 1 a 2073600.

Propriedades do parâmetro

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

-ShortSessionTimeout

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o tempo, em segundos, que um usuário tem para estabelecer a interação inicial com uma planilha. Após esse tempo, se o usuário não estiver ativo, a sessão será fechada. O valor sempre deve ser menor que SessionTimeout. Se o valor de ShortSessionTimeout for superior ou igual a SessionTimeout, será retornado um erro. O valor padrão é 75.

O tipo deve ser -1 ou um inteiro no intervalo de 1 a 2073600.

Propriedades do parâmetro

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

-UdfsAllowed

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica que as funções definidas pelo usuário podem ser chamadas pelas pastas de trabalho carregadas no local de arquivo confiável especificado em Address.

Propriedades do parâmetro

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

-WarnOnDataRefresh

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica a exibição de um aviso ao usuário na primeira atualização de dados da pasta de trabalho. O valor padrão é True.

Propriedades do parâmetro

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

-WorkbookSizeMax

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o tamanho máximo, em megabytes, de uma pasta de trabalho que pode ser carregada. O valor padrão é 10.

O tipo deve ser um valor inteiro no intervalo de 1 a 2000.

Propriedades do parâmetro

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

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.