New-SPExcelFileLocation
Adiciona um novo local confiável ao Aplicativo de Serviços do Excel.
Syntax
New-SPExcelFileLocation
-Address <String>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AbortOnRefreshOnOpenFail]
[-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 New-SPExcelFileLocation cmdlet adiciona um novo local à lista de locais de arquivo confiáveis em um aplicativo de serviço Web de aplicativo Serviços do Excel.
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 carregadas em Serviços do Excel Aplicativo.
Serviços do Excel Aplicativo sempre impõe as propriedades definidas pelo local do arquivo confiável do qual uma pasta de trabalho foi carregada.
As propriedades que o local de arquivo confiável usa são determinadas pela comparação do caminho de arquivo da pasta de trabalho com o parâmetro Address do local de arquivo confiável.
A maior correspondência tem prioridade. Por exemplo, se https://portal/site/ e https://portal/site/subsite são locais confiáveis e você carrega uma pasta de trabalho do subsite, o aplicativo usa as propriedades do local confiável do subsite porque tem o endereço correspondente mais longo.
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" | New-SPExcelFileLocation -address "https://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$falseEste exemplo adiciona um novo local de arquivo confiável à lista de locais de arquivo confiáveis que está no aplicativo de serviço Web de aplicativo Serviços do Excel chamado MyExcelService.
Este exemplo permite que as pastas de trabalho carreguem de qualquer criança ou subpasta que comece com https://myPortal/myTeam. Todas as pastas de trabalho carregadas deste local devem ser menores que 50 MB. As pastas de trabalho podem atualizar dados externos usando conexões que são inseridas no arquivo da pasta de trabalho ou armazenadas em uma biblioteca de conexões de dados. Uma mensagem de aviso de que a pasta de trabalho está tentando atualizar dados externos não será exibida.
------------------EXEMPLO 2------------------
Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address https://myPortal/myTeam/managers -locationType SharePoint -description "This is the manager's subsite for myTeam."Este exemplo adiciona um novo local de arquivo confiável à lista de locais de arquivo confiáveis que está no aplicativo de serviço Web de aplicativo Serviços do Excel chamado MyExcelService com um determinado endereço e descrição.
Parâmetros
-AbortOnRefreshOnOpenFail
Especifica que o carregamento 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 do SharePoint Product and Technologies para o arquivo.
- O arquivo de pasta de trabalho tem conexões de dados atualizadas automaticamente quando o arquivo Serviços do Excel Aplicativo é 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
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: | True |
| 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 Caches 1 segundo a 24 dias. O valor inteiro padrão é 300.
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
{{Fill ChartRenderDurationMax Description}}
| 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. As configurações diferentes de File substituem as configurações da pasta de trabalho. 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 a dados externos permitido para pastas de trabalho. None 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 uma das seguintes configurações:
Nenhum
Dcl
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 |
-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 verdadeiro, https://portal/subSite também será confiável, assim como qualquer URL subordinada à 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
Especifica o tipo de local. O tipo de local indica como Serviços do Excel Aplicativo recupera arquivos do local especificado em Endereço. A configuração padrão é o tipo SharePoint. 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 reemitir 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. O valor padrão é 300.
Os valores válidos são um dos seguintes itens:
-1 Nunca atualiza após a primeira consulta.1 a 2073600- Obtém 1 segundo para 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 |
-NewWorkbookSessionTimeout
Especifica a hora, em segundos, que uma sessão para uma pasta de trabalho nova, não salva permanece ativa no aplicativo Serviços do Excel sem atividade do usuário. 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 valor padrão é 1800.
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 de -1 especifica que nunca será atualizado após a primeira consulta. O valor padrão é 300.
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 |
-RequestDurationMax
Especifica a duração máxima, em segundos, para uma única solicitação em uma sessão. Depois que esse tempo passa, a solicitação acaba. O valor padrão é 300.
O tipo deve ser -1 (sem limite) 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 |
-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 tem efeito se o parâmetro ExternalDataAllowed está definido como None.
| 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, que uma sessão permanece ativa no aplicativo Serviços do Excel sem atividade do usuário. Os valores válidos incluem:
-1 A sessão nunca expira.
A sessão 0 expira no final de uma única solicitação.
1 a 2073600 Permanece ativo de 1 segundo a 24 dias. O valor padrão é 300.
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 funções definidas pelo usuário podem ser chamadas pelas pastas de trabalho que são carregadas no local de arquivo confiável especificado em Address.
O valor padrão é False.
| 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