New-SPExcelServiceApplication
Cria uma nova instância do Aplicativo de Serviços do Excel.
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
O New-SPExcelServiceApplication cmdlet cria um novo aplicativo de serviço Web do Aplicativo de Serviços do Excel com novas configurações.
Depois de criar um novo aplicativo de serviço Web do aplicativo de Serviços do Excel, você pode usar o Set-SPExcelServiceApplication cmdlet para modificar as configurações globais do novo aplicativo.
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
New-SPExcelServiceApplication -Name "MyExcelService" -ApplicationPool "SharePoint Services"
Este exemplo cria uma nova instância do Aplicativo de Serviços do Serviços do Excel com o nome de exibição MyExcelService.
EXEMPLO 2
New-SPExcelServiceApplication -Name "My Excel Service" -ApplicationPool "SharePoint Services" -SessionsPerUserMax 5
Este exemplo cria uma nova instância do Aplicativo de Serviços do Excel do Excel com o nome de exibição Meu Serviço do Excel e permite apenas cinco sessões por usuário para cada computador servidor de aplicativos back-end que está executando o Aplicativo de Serviços do Excel.
Parâmetros
-ApplicationPool
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica o pool de aplicativos do IIS existente no qual executar o serviço Web para o novo aplicativo do Serviço do Excel.
O tipo deve ser um objeto SPIisWebServiceApplicationPool válido.
Propriedades do parâmetro
| Tipo: | SPIisWebServiceApplicationPoolPipeBind |
| 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: | 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 |
-CachingOfUnusedFilesEnable
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica que os arquivos que não são mais usados pelo Aplicativo de Serviços do Excel podem permanecer no cache para uso posterior. O padrão é verdadeiro quando o parâmetro não é especificado no comando.
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 |
-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 |
-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
| 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 |
-Default
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica que o proxy desse aplicativo de serviço é adicionado ao grupo de proxy padrão do farm.
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 |
-EncryptedUserConnectionRequired
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Requer que a criptografia seja usada entre o usuário final e o servidor de Aplicativos dos 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
| Tipo: | EncryptedConnectionMode |
| 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 |
-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 Permaneça ativo de 1 segundo a 24 dias.
O valor padrão é 1800.
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 |
-FileAccessMethod
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica o método de autenticação que o Aplicativo de Serviços do Serviços do Excel usa para recuperar arquivos. UseFileAccessAccount especifica que todas as pastas de trabalho sempre usam as credenciais da conta de serviço que executa o Aplicativo de Serviços do Excel. UseImpersonation especifica que o Aplicativo de Serviços do Excel recupera os arquivos de pasta de trabalho como o usuário que está fazendo a solicitação. O valor padrão é UseImpersonation.
O tipo deve ser um dos seguintes: UseImpersonation ou UseFileAccessAccount.
Propriedades do parâmetro
| Tipo: | FileAccessMethod |
| 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 |
-LoadBalancingScheme
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica o esquema de balanceamento de carga usado pelo aplicativo do Serviço Web do Aplicativo de Serviços do Excel para enviar solicitações a diferentes computadores back-end que estão executando 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
| Tipo: | LoadBalancingScheme |
| 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 |
-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
| 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 |
-Name
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica um nome amigável para o novo aplicativo de serviço Web do Aplicativo de Serviços do Excel. O nome que você usar deverá ser um nome exclusivo de um aplicativo de serviço Web do Aplicativo de Serviços do Excel que esteja neste farm. O nome pode ter, no máximo, 128 caracteres. O valor padrão é Service_numofapplications+1.
O tipo deve ser uma cadeia de caracteres válida; por exemplo, MyExcelServiceApp1.
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 |
-PrivateBytesMax
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica o máximo de bytes privados, em megabytes, usados pelo Aplicativo de Serviços do Excel. 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
| 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 |
-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 usuário atingir esse limite máximo, a sessão mais antiga será excluída quando uma nova sessão for iniciada. 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
| 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 |
-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
| 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 |
-TerminateProcessOnAccessViolation
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Encerra o Aplicativo de Serviços do Excel quando ocorre uma violação de acesso no processo.
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 |
-ThrottleAccessViolationsPerSiteCollection
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica que, se uma pasta de trabalho causar um erro de violação de acesso no Aplicativo de Serviços do Excel, todos os arquivos originados do conjunto de sites dessa pasta de trabalho serão impedidos de carregar pelo 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
| 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 |
-UnattendedAccountApplicationId
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica que a ID do aplicativo usada para pesquisar as credenciais da conta de serviço autônoma do serviço de repositório seguro especificado por UnattendedAccountSecureServiceAppName. O serviço de repositório seguro é contatado quando esse parâmetro é definido e ocorrem casos de erro específicos. Os valores válidos são cadeias de caracteres alfanuméricas com no máximo 256 caracteres. 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
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ExistingTargetApplicationParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UnattendedServiceAccount
Aplicável: SharePoint Server 2010, SharePoint Server 2013
{{Preencher descrição UnattendedServiceAccount}}
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
NewTargetApplicationParameterSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-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
| 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 |
-UseEffectiveUserName
Aplicável: SharePoint Server 2010, SharePoint Server 2013
{{Preencher descrição UseEffectiveUserName}}
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 |
-WorkbookCache
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica a localização do sistema de arquivos local do cache usado para armazenar pastas de trabalho usadas pelo Aplicativo de Serviços do Excel.
Se nenhum valor for especificado, o valor padrão será 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
| 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 |
-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
| 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 |
-WorkbookModelUsageTracker
Aplicável: SharePoint Server 2010, SharePoint Server 2013
{{Preencher WorkbookModelUsageTracker Descrição}}
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 |
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.