Set-SPExcelFileLocation
Define as propriedades de um local de arquivo confiável do Aplicativo de Serviços do Excel.
Syntax
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 Serviços do Excel Aplicativo carrega pastas de trabalho.
Serviços do Excel Aplicativo carrega apenas pastas de trabalho armazenadas em um local de arquivo confiável.
Propriedades de locais de arquivo confiáveis controlam como as pastas de trabalho podem ser usadas quando são carregadas no aplicativo Serviços do Excel.
Serviços do Excel Aplicativo 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 DclEste exemplo obtém cada local de arquivo confiável para o aplicativo de serviço Web de aplicativo Serviços do Excel chamado My Excel Service 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 de aplicativo Serviços do Excel no farm.
Parâmetros
-AbortOnRefreshOnOpenFail
Especifica que a carga de um arquivo Serviços do Excel Aplicativo falha automaticamente se uma operação automática de atualização de dados falhar quando o arquivo é aberto. A carga só falhará se ocorrerem as seguintes condições:
-- O usuário tem permissões somente leitura para o arquivo Serviços do Excel Aplicativo. -- O arquivo da pasta de trabalho tem conexões de dados que são automaticamente atualizadas quando o arquivo do Excel é aberto.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Address
System.String
Especifica uma pasta Da Web ou um diretório de arquivo do qual Serviços do Excel Aplicativo 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
| 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 |
-AutomaticVolatileFunctionCacheLifetime
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ChartAndImageSizeMax
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ChartRenderDurationMax
O tempo máximo (em segundos) gasto renderizando qualquer gráfico único.
Valores válidos: -1 (sem limite); de 1 a 2073600 (24 dias).
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ConcurrentDataRequestsPerSessionMax
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-DefaultWorkbookCalcMode
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 Serviços do Excel quando o cache de propriedades ConfigDB for atualizado. A configuração padrão é File.
O tipo deve ser um dos seguintes: File, Manual, Auto ou AutoDataTables.
| Type: | DefaultWorkbookCalcMode |
| 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 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.
| 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 |
-DisplayGranularExtDataErrors
Exibe mensagens de erro granulares para falhas de dados externos de arquivos neste local.
| Type: | SwitchParameter |
| 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 Serviços do Excel Aplicativo que contém o objeto de lista SPExcelFileLocation.
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 |
-ExternalDataAllowed
Especifica o tipo de acesso de dados externo 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.
| Type: | AllowExternalData |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Identity
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 formulário 12345678-90ab-cdef-1234-567890bcdefgh; uma cadeia de caracteres válida que identifica o local do arquivo, no formulário https://myPortal/myTeam; uma cadeia de caracteres válida que identifica o caminho, no formulário C:\folder_name; ou uma instância de um objeto SPExcelFileLocation válido.
| Type: | SPExcelFileLocationPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-IncludeChildren
Indica que as URLs, os diretórios e as bibliotecas subordinados são confiáveis. Por exemplo, se o local do arquivo confiável for https://portal, e IncludeChildren for true, também https://portal/subSite será confiável, assim como qualquer subURL na URL especificada em Endereço.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-LocationType
O tipo de local. LocationType indica como Serviços do Excel Aplicativo recupera arquivos desse local especificado em Endereço. O valor padrão é SharePoint.
O tipo deve ser um dos seguintes: SharePoint, UNC ou HTTP.
| Type: | LocationType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ManualExtDataCacheLifetime
Especifica a hora, em segundos, que Serviços do Excel Aplicativo aguarda antes de emitir novamente uma solicitação de dados externa iniciada pelo usuário ou manual. 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 1 segundo a 24 dias.
O valor padrão é 300.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-NewWorkbookSessionTimeout
Especifica a hora, em segundos, que uma sessão para uma pasta de trabalho nova e não salva permanecerá ativa no aplicativo Serviços do Excel sem 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 no final de uma única solicitação
1 a 2073600, permaneça ativo de 1 segundo a 24 dias.
O tipo deve ser -1 ou um inteiro no intervalo de 1 a 2073600.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-PeriodicExtDataCacheLifetime
Especifica a hora, em segundos, que Serviços do Excel Aplicativo aguarda antes de emitir novamente uma solicitação de dados externa aberta 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-RequestDurationMax
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-RESTExternalDataAllowed
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 DataAllowed Externo estiver definido como Nenhum.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-SessionTimeout
Especifica a hora, em segundos, de que uma sessão permanecerá ativa no aplicativo Serviços do Excel sem 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 no 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ShortSessionTimeout
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UdfsAllowed
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WarnOnDataRefresh
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-WorkbookSizeMax
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de