Compartilhar via


New-SPExcelFileLocation

Adiciona um novo local confiável ao Aplicativo de Serviços do Excel.

Sintaxe

Default (Padrão)

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 uma nova localização à lista de localizações de ficheiro fidedignas numa aplicação do serviço Web da Aplicação Serviços do Excel. Serviços do Excel a Aplicação carrega apenas livros armazenados numa localização de ficheiro fidedigna. As propriedades das localizações de ficheiros fidedignas controlam a forma como os livros podem ser utilizados quando carregados na Aplicação Serviços do Excel. Serviços do Excel Aplicação impõe sempre as propriedades definidas pela localização de ficheiro fidedigna a partir da qual um livro foi carregado. 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 forem localizações fidedignas e carregar um livro a partir do subsite, a aplicação utiliza as propriedades da localização fidedigna 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:$false

Este exemplo adiciona uma nova localização de ficheiro fidedigna à lista de localizações de ficheiro fidedignas que se encontra na aplicação do serviço Web da Aplicação Serviços do Excel denominada MyExcelService.

Este exemplo permite que os livros carreguem a partir de qualquer subordinado ou subpasta que comece por 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 uma nova localização de ficheiro fidedigna à lista de localizações de ficheiro fidedignas que se encontra na aplicação do serviço Web da Aplicação Serviços do Excel denominada MyExcelService com um determinado endereço e descrição.

Parâmetros

-AbortOnRefreshOnOpenFail

Aplicável: SharePoint Server 2010, SharePoint Server 2013

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

  • O utilizador tem permissões só de leitura de Produtos e Tecnologias do SharePoint para o ficheiro.
  • O ficheiro do livro tem ligações de dados que são atualizadas automaticamente quando o ficheiro Serviços do Excel Aplicação é 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

Especifica uma pasta Web ou um diretório de ficheiros a partir do qual Serviços do Excel Aplicação pode carregar livros.

O tipo tem de ser um URL válido, 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: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

-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 o livro é carregado.

0 Calcula sempre.

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.

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

{{Fill ChartRenderDurationMax Description}}

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

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

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

-ExternalDataAllowed

Aplicável: SharePoint Server 2010, SharePoint Server 2013

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

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

-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 a localização do ficheiro fidedigno for https://portal e IncludeChildren for verdadeira, https://portal/subSite também é fidedigno, tal como qualquer URL subordinado ao URL especificado 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

Especifica o tipo de local. O tipo de localização indica como Serviços do Excel Aplicação obtém ficheiros a partir da localização especificada 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.

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 a hora, em segundos, que Serviços do Excel Aplicação aguarda antes de voltar a emitir um pedido de dados externo manual ou iniciado pelo utilizador. 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.

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 a hora, em segundos, de que uma sessão para um livro novo, não guardado, permanece ativa no Serviços do Excel Aplicação sem atividade de utilizador. 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 1 segundo a 24 dias. O valor padrão é 1800.

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 Serviços do Excel Aplicação aguarda antes de voltar a emitir um pedido de dados externos aberto ou periódico (ou seja, automático). 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.

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, para uma única solicitação em uma sessão. Após este tempo decorrido, o pedido excede o limite de tempo. O valor predefinido é 300.

O tipo deve ser -1 (sem limite) 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

-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 tem efeito se o parâmetro ExternalDataAllowed está 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, em que uma sessão permanece ativa no Serviços do Excel Aplicação sem atividade de utilizador. Os valores válidos incluem:

-1   A sessão nunca expira.

0 sessão expira no final de um único pedido.

1 a 2073600 Permanece ativo 1 segundo a 24 dias. O valor padrão é 300.

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

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