New-SPExcelServiceApplication
Cria uma nova instância do Aplicativo de Serviços do Excel.
Syntax
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>] 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 uma nova Serviços do Excel aplicativo de serviço Web de aplicativo com novas configurações.
Depois de criar uma nova Serviços do Excel aplicativo de serviço Web de aplicativo, 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 Serviços do Excel com o nome de exibição MyExcelService.
------------------EXEMPLO 2------------------
New-SPExcelServiceApplication -Name "My Excel Service" -ApplicationPool "SharePoint Services" -SessionsPerUserMax 5Este exemplo cria uma nova instância do aplicativo Serviços do Excel com o nome de exibição My Excel Service e permite apenas cinco sessões por usuário para cada computador de servidor de aplicativo de back-end que está executando Serviços do Excel Aplicativo.
Parâmetros
-ApplicationPool
Especifica o pool de aplicativos IIS existente para executar o serviço Web no novo aplicativo do Serviço excel.
O tipo deve ser um objeto SPIisWebServiceApplicationPool válido.
| Type: | SPIisWebServiceApplicationPoolPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 |
-CachingOfUnusedFilesEnable
Especifica que os arquivos que não são mais usados pelo Serviços do Excel Aplicativo podem permanecer no cache para uso posterior. O padrão é verdadeiro quando o parâmetro não é especificado no comando.
| 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 |
-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 |
-CrossDomainAccessAllowed
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.
| 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 |
-Default
Especifica que o proxy desse aplicativo de serviço é adicionado ao grupo de proxy padrão do farm.
| 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 |
-EncryptedUserConnectionRequired
Exige que a criptografia seja usada entre o usuário final e o servidor de aplicativo 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.
| Type: | EncryptedConnectionMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ExternalDataConnectionLifetime
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 Permanecer ativo de 1 segundo a 24 dias.
O valor padrão é 1800.
| 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 |
-FileAccessMethod
Especifica o método de autenticação que Serviços do Excel Aplicativo usa para recuperar arquivos. UseFileAccessAccount especifica que todas as pastas de trabalho sempre usam as credenciais da conta de serviço que executa Serviços do Excel Aplicativo. UseImpersonation especifica que Serviços do Excel Aplicativo recupera os arquivos da 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.
| Type: | FileAccessMethod |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-LoadBalancingScheme
Especifica o esquema de balanceamento de carga usado pelo aplicativo Serviços do Excel Serviço Web de Aplicativo para enviar solicitações para 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.
| Type: | LoadBalancingScheme |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-MemoryCacheThreshold
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.
| 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 |
-Name
Especifica um nome amigável para o novo aplicativo de serviço Web de aplicativo Serviços do Excel. O nome que você usa deve ser um nome exclusivo de um aplicativo de serviço Web de aplicativo Serviços do Excel que está 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.
| 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 |
-PrivateBytesMax
Especifica os bytes privados máximos, em megabytes, usados pelo aplicativo 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.
| 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 |
-SessionsPerUserMax
Especifica o número máximo de sessões permitidas para um usuário. Se um usuário atingir esse 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.
| 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 |
-SiteCollectionAnonymousSessionsMax
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.
| 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 |
-TerminateProcessOnAccessViolation
Encerra Serviços do Excel Aplicativo quando ocorre uma violação de acesso no processo.
| 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 |
-ThrottleAccessViolationsPerSiteCollection
Especifica que, se uma pasta de trabalho causar um erro de violação de acesso no aplicativo Serviços do Excel, todos os arquivos originados da coleção 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.
| 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 |
-UnattendedAccountApplicationId
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 especificada 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 um máximo de 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.
| 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 |
-UnattendedServiceAccount
{{Preencher UnattendedServiceAccount Description}}
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UnusedObjectAgeMax
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.
| 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 |
-UseEffectiveUserName
{{Fill UseEffectiveUserName Description}}
| 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 |
-WorkbookCache
Especifica o local do sistema de arquivos local do cache que é usado para armazenar pastas de trabalho usadas pelo aplicativo 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
| 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 |
-WorkbookCacheSizeMax
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.
| 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 |
-WorkbookModelUsageTracker
{{Preencher WorkbookModelUsageTracker Description}}
| 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 |