New-SPExcelServiceApplication

Sintaxe

ExistingTargetApplicationParameterSet

New-SPExcelServiceApplication
    -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
    [-Name <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CachingOfUnusedFilesEnable]
    [-Confirm]
    [-CrossDomainAccessAllowed]
    [-Default]
    [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
    [-ExternalDataConnectionLifetime <Int32>]
    [-FileAccessMethod <FileAccessMethod>]
    [-LoadBalancingScheme <LoadBalancingScheme>]
    [-MemoryCacheThreshold <Int32>]
    [-PrivateBytesMax <Int32>]
    [-SessionsPerUserMax <Int32>]
    [-SiteCollectionAnonymousSessionsMax <Int32>]
    [-TerminateProcessOnAccessViolation]
    [-ThrottleAccessViolationsPerSiteCollection <Int32>]
    [-UnattendedAccountApplicationId <String>]
    [-UnusedObjectAgeMax <Int32>]
    [-WhatIf]
    [-WorkbookCache <String>]
    [-WorkbookCacheSizeMax <Int32>]
    [-UseEffectiveUserName]
    [-WorkbookModelUsageTracker <String>]
    [<CommonParameters>]

NewTargetApplicationParameterSet

New-SPExcelServiceApplication
    -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
    [-Name <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CachingOfUnusedFilesEnable]
    [-Confirm]
    [-CrossDomainAccessAllowed]
    [-Default]
    [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
    [-ExternalDataConnectionLifetime <Int32>]
    [-FileAccessMethod <FileAccessMethod>]
    [-LoadBalancingScheme <LoadBalancingScheme>]
    [-MemoryCacheThreshold <Int32>]
    [-PrivateBytesMax <Int32>]
    [-SessionsPerUserMax <Int32>]
    [-SiteCollectionAnonymousSessionsMax <Int32>]
    [-TerminateProcessOnAccessViolation]
    [-ThrottleAccessViolationsPerSiteCollection <Int32>]
    [-UnusedObjectAgeMax <Int32>]
    [-WhatIf]
    [-WorkbookCache <String>]
    [-WorkbookCacheSizeMax <Int32>]
    [-UnattendedServiceAccount <PSCredential>]
    [-UseEffectiveUserName]
    [-WorkbookModelUsageTracker <String>]
    [<CommonParameters>]

Description

Exemplos

EXEMPLO 1

New-SPExcelServiceApplication -Name "MyExcelService" -ApplicationPool "SharePoint Services"

EXEMPLO 2

New-SPExcelServiceApplication -Name "My Excel Service" -ApplicationPool "SharePoint Services" -SessionsPerUserMax 5

Parâmetros

-ApplicationPool

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o conjunto aplicacional do IIS existente para executar o serviço Web na nova aplicação do Serviço do Excel.

O tipo tem de ser um objeto SPIisWebServiceApplicationPool válido.

Propriedades do parâmetro

Conjuntos de parâmetros

-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

Conjuntos de parâmetros

-CachingOfUnusedFilesEnable

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica que os ficheiros que já não são utilizados pelo Serviços do Excel Aplicação podem permanecer na cache para utilização posterior. O padrão é verdadeiro quando o parâmetro não é especificado no comando.

Propriedades do parâmetro

Conjuntos de parâmetros

-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

Conjuntos de parâmetros

-CrossDomainAccessAllowed

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica que os arquivos de conexão de dados e as pastas de trabalho confiáveis podem ser solicitados e renderizados por Web Parts ou páginas que residem em outros domínios HTTP.

Propriedades do parâmetro

Conjuntos de parâmetros

-Default

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica que o proxy para esta aplicação de serviço é adicionado ao grupo de proxy predefinido do farm.

Propriedades do parâmetro

Conjuntos de parâmetros

-EncryptedUserConnectionRequired

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Requer que a encriptação seja utilizada entre o utilizador final e o servidor da Aplicação Serviços do Excel. O escopo dessa configuração é o servidor lógico. O valor padrão é None.

O tipo deve ser um dos seguintes valores: None ou Connection.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExternalDataConnectionLifetime

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o número máximo de segundos que uma conexão de dados externos pode permanecer aberta no pool de conexões. Os valores válidos incluem:

-1 Nunca reciclar

1 a 2073600 Permanecem ativos 1 segundo a 24 dias.

O valor predefinido é 1800.

Propriedades do parâmetro

Conjuntos de parâmetros

-FileAccessMethod

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o método de autenticação que Serviços do Excel a Aplicação utiliza para obter ficheiros. UseFileAccessAccount especifica que todos os livros utilizam sempre as credenciais da conta de serviço em execução Serviços do Excel Aplicação. UseImpersonation especifica que Serviços do Excel Aplicação obtém os ficheiros do livro como o utilizador que está a fazer o pedido. O valor padrão é UseImpersonation.

O tipo deve ser um dos seguintes: UseImpersonation ou UseFileAccessAccount.

Propriedades do parâmetro

Conjuntos de parâmetros

-LoadBalancingScheme

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o esquema de balanceamento de carga que é utilizado pela aplicação do serviço Web da Aplicação Serviços do Excel para enviar pedidos para diferentes computadores de back-end que executem os Serviços de Cálculo do Excel. O valor padrão é WorkbookURL.

O tipo deve ser um dos seguintes: RoundRobin, Local ou WorkbookURL.

Propriedades do parâmetro

Conjuntos de parâmetros

-MemoryCacheThreshold

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica a porcentagem referente ao máximo de bytes privados que podem ser alocados a objetos inativos. Quando o limite de cache da memória é excedido, os objetos armazenados em cache e que, no momento, não estão em uso são liberados. Definir esse valor como 0 desabilita o cache de objetos inativos. O valor padrão é 90.

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica um nome amigável para a nova aplicação do serviço Web da Aplicação Serviços do Excel. O nome que utiliza tem de ser um nome exclusivo de uma aplicação do serviço Web da Aplicação Serviços do Excel que se encontra neste farm. O nome pode ter, no máximo, 128 caracteres. O valor predefinido é Service_numofapplications+1.

O tipo tem de ser uma cadeia válida; por exemplo, MyExcelServiceApp1.

Propriedades do parâmetro

Conjuntos de parâmetros

-PrivateBytesMax

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o máximo de bytes privados, em megabytes, utilizados pelo Serviços do Excel Application. Quando definido como -1, o máximo de bytes particulares assume o padrão de 50% da memória física existente no computador. Os valores válidos incluem -1 para sem limite e qualquer inteiro positivo. O valor padrão é -1.

O tipo deve ser -1 ou qualquer inteiro positivo.

Propriedades do parâmetro

Conjuntos de parâmetros

-SessionsPerUserMax

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o número máximo de sessões permitidas para um usuário. Se um utilizador atingir este máximo, a sessão mais antiga será eliminada quando for iniciada uma nova sessão. Os valores válidos incluem: -1 para sem limite e qualquer inteiro positivo. O valor padrão é 25.

O tipo deve ser -1 ou qualquer inteiro positivo.

Propriedades do parâmetro

Conjuntos de parâmetros

-SiteCollectionAnonymousSessionsMax

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o número máximo de sessões anônimas permitidas por conjunto de sites. Um valor 0 especifica que nenhuma sessão anônima é permitida. Os valores válidos incluem -1 para sem limite, 0 para desabilitar a configuração ou qualquer inteiro positivo. O valor padrão é 25.

O tipo deve ser -1, 0 ou qualquer inteiro positivo.

Propriedades do parâmetro

Conjuntos de parâmetros

-TerminateProcessOnAccessViolation

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Termina Serviços do Excel Aplicação quando ocorre uma violação de acesso no processo.

Propriedades do parâmetro

Conjuntos de parâmetros

-ThrottleAccessViolationsPerSiteCollection

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica que, se um livro causar um erro de violação de acesso na Aplicação Serviços do Excel, todos os ficheiros provenientes da coleção de sites desse livro serão impedidos de ser carregados durante o período especificado (em segundos). As sessões existentes para os arquivos desse conjunto de sites não serão afetadas. Os valores válidos incluem 0 para desabilitar a configuração e o intervalo de 1 a 2073600 segundos (24 dias). O valor padrão é 0.

O tipo deve ser um valor inteiro no intervalo de 0 a 2073600.

Propriedades do parâmetro

Conjuntos de parâmetros

-UnattendedAccountApplicationId

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica que o ID da aplicação que é utilizado para procurar as credenciais da conta de serviço automática do serviço de arquivo seguro especificado por UnattendedAccountSecureServiceAppName. O serviço de arquivo seguro é contactado quando este parâmetro é definido e ocorrem casos de erro específicos. Os valores válidos são cadeias alfanuméricas com um máximo de 256 carateres. O valor padrão é uma cadeia de caracteres vazia.

O tipo deve ser uma cadeia válida de caracteres alfanuméricos; por exemplo, UnattendedServiceAccountID.

A conta autônoma é uma conta única que todas as pastas de trabalho podem usar para atualizar os dados. Uma conta autônoma é necessária quando as conexões da pasta de trabalho especificam Nenhuma para autenticação ou quando qualquer credencial não Windows é usada para atualizar dados.

Propriedades do parâmetro

Conjuntos de parâmetros

-UnattendedServiceAccount

Aplicável: SharePoint Server 2010, SharePoint Server 2013

{{Fill UnattendedServiceAccount Description}}

Propriedades do parâmetro

Conjuntos de parâmetros

-UnusedObjectAgeMax

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o máximo de tempo, em minutos, que os objetos que não estão em uso em uma sessão são mantidos no cache da memória. Os valores válidos incluem -1 para configuração sem máximo, e um inteiro positivo no intervalo de 1 a 34560 minutos (24 dias). O valor padrão é -1.

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

Propriedades do parâmetro

Conjuntos de parâmetros

-UseEffectiveUserName

Aplicável: SharePoint Server 2010, SharePoint Server 2013

{{Fill UseEffectiveUserName Description}}

Propriedades do parâmetro

Conjuntos de parâmetros

-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

Conjuntos de parâmetros

-WorkbookCache

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica a localização local do sistema de ficheiros da cache que é utilizada para armazenar livros utilizados pelo Serviços do Excel Application.

Se não for especificado nenhum valor, o valor predefinido é um subdiretório no diretório temporário do sistema.

O tipo deve ser um caminho válido em um dos seguintes formatos:

-- C:\folder_name -- \\server_name\folder_name

Propriedades do parâmetro

Conjuntos de parâmetros

-WorkbookCacheSizeMax

Aplicável: SharePoint Server 2010, SharePoint Server 2013

Especifica o tamanho máximo permitido, em megabytes, de uma sessão individual. O valor padrão é 0.

O tipo deve ser qualquer inteiro positivo.

Propriedades do parâmetro

Conjuntos de parâmetros

-WorkbookModelUsageTracker

Aplicável: SharePoint Server 2010, SharePoint Server 2013

{{Fill WorkbookModelUsageTracker Description}}

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters