Set-OfficeWebAppsFarm

Sintaxe

Default (Default)

Set-OfficeWebAppsFarm
    [-Force]
    [-FarmOU <String>]
    [-InternalURL <String>]
    [-ExternalURL <String>]
    [-AllowHttp]
    [-AllowOutboundHttp]
    [-SSLOffloaded]
    [-CertificateName <String>]
    [-S2SCertificateName <String>]
    [-EditingEnabled]
    [-Proxy <String>]
    [-LogLocation <String>]
    [-LogRetentionInDays <UInt32>]
    [-LogVerbosity <String>]
    [-CacheLocation <String>]
    [-MaxMemoryCacheSizeInMB <Int32>]
    [-DocumentInfoCacheSize <UInt32>]
    [-CacheSizeInGB <Int32>]
    [-ClipartEnabled]
    [-TranslationEnabled]
    [-MaxTranslationCharacterCount <Int32>]
    [-TranslationServiceAppId <String>]
    [-TranslationServiceAddress <String>]
    [-RenderingLocalCacheLocation <String>]
    [-RecycleActiveProcessCount <UInt32>]
    [-AllowCEIP]
    [-ExcelRequestDurationMax <Int32>]
    [-ExcelSessionTimeout <Int32>]
    [-ExcelWorkbookSizeMax <Int32>]
    [-ExcelPrivateBytesMax <Int32>]
    [-ExcelConnectionLifetime <Int32>]
    [-ExcelExternalDataCacheLifetime <Int32>]
    [-ExcelAllowExternalData]
    [-ExcelUseEffectiveUserName]
    [-ExcelWarnOnDataRefresh]
    [-ExcelUdfsAllowed]
    [-ExcelMemoryCacheThreshold <Int32>]
    [-ExcelUnusedObjectAgeMax <Int32>]
    [-ExcelCachingUnusedFiles]
    [-ExcelAbortOnRefreshOnOpenFail]
    [-ExcelAutomaticVolatileFunctionCacheLifeTime <Int32>]
    [-ExcelConcurrentDataRequestsPerSessionMax <Int32>]
    [-ExcelDefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
    [-ExcelRestExternalDataEnabled]
    [-ExcelChartAndImageSizeMax <Int32>]
    [-OpenFromUrlEnabled]
    [-OpenFromUncEnabled]
    [-OpenFromUrlThrottlingEnabled]
    [-PicturePasteDisabled]
    [-RemovePersonalInformationFromLogs]
    [-AllowHttpSecureStoreConnections]
    [-WhatIf]
    [-Confirm]

Description

Exemplos

EXEMPLO 1

Set-OfficeWebAppsFarm -ClipartEnabled:$true

EXEMPLO 2

Set-OfficeWebAppsFarm -EditingEnabled:$true

EXEMPLO 3

Set-OfficeWebAppsFarm -OpenFromUncEnabled:$false

Parâmetros

-AllowCEIP

Habilita a geração de relatórios do Programa de Aperfeiçoamento da Experiência do Usuário (CEIP) em todos os servidores no farm do Servidor do Office Online.

Você deve reiniciar todos os servidores no farm do Servidor do Servidor do Office Online para que esta alteração entre em vigor.

Propriedades do parâmetro

Conjuntos de parâmetros

-AllowHttp

Indica que os sites do IIS devem ser provisionados na porta 80 para acesso HTTP. Use o AllowHTTP apenas em ambientes onde todos os computadores exigem IPSEC (criptografia completa) ou em ambientes de teste que não contêm arquivos sensíveis.

Habilitado automaticamente quando o SSLOffloaded é habilitado.

É necessário reiniciar cada servidor no farm para que esta alteração tenha efeito.

Propriedades do parâmetro

Conjuntos de parâmetros

-AllowHttpSecureStoreConnections

Indica que as conexões de repositório seguro podem ser estabelecidas usando conexões não SSL (como HTTP). O padrão é False.

Use AllowHTTPSecureStoreConnections somente em ambientes onde todos os computadores exigem IPSEC (criptografia total) ou em ambientes de teste que não contêm arquivos sigilosos.

Propriedades do parâmetro

Conjuntos de parâmetros

-AllowOutboundHttp

Permite conexões HTTP de saída do Servidor do Office Online.

Propriedades do parâmetro

Conjuntos de parâmetros

-CacheLocation

Especifica o local do cache de disco global usado para armazenar arquivos de imagem renderizados. O local padrão é %programdata%\Microsoft\OfficeWebApps\Working\d\.

Propriedades do parâmetro

Conjuntos de parâmetros

-CacheSizeInGB

Especifica o tamanho máximo do cache de disco global em gigabytes. O tipo deve ser um valor inteiro no intervalo de 0 a qualquer inteiro positivo. O valor padrão é 15 MB.

Propriedades do parâmetro

Conjuntos de parâmetros

-CertificateName

Especifica o nome amigável do certificado que o Servidor do Office Online usa para criar associações HTTPS.

Se o certificado especificado não é encontrado ou expirar ou se o valor especificado é associado com mais de um certificado, um erro é registrado e o farm não é criado.

Esse valor é usado em cada servidor que ingressa no farm do Servidor do Office Online. Portanto, cada servidor no farm deve ter um certificado que possui este nome amigável.

Você não precisará especificar o parâmetro CertificateName se estiver usando o parâmetro AllowHttp ou SSLOffloaded.

É necessário reiniciar cada servidor no farm para que esta alteração tenha efeito.

Propriedades do parâmetro

Conjuntos de parâmetros

-ClipartEnabled

Habilita o suporte para inserção de clip-art de Office.com em documentos do Office. Este recurso exige comunicações do servidor para Web, configurado diretamente ou usando um proxy especificado usando o parâmetro Proxy.

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Solicita sua confirmação antes de executar o comando.

Propriedades do parâmetro

Conjuntos de parâmetros

-DocumentInfoCacheSize

Especifica o número máximo de registros de conversão do documento armazenados em um cache de memória.

O valor padrão é 5000 registros.

Propriedades do parâmetro

Conjuntos de parâmetros

-EditingEnabled

Habilita o suporte para edição no navegador. O padrão é False. Definido como True somente se você tiver o licenciamento apropriado para usar a funcionalidade de edição.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelAbortOnRefreshOnOpenFail

Impede que uma pasta de trabalho seja carregada se houver falha na atualização de dados. Isso ajuda a impedir que os usuários vejam informações desatualizadas ou a que possivelmente não deveriam ter acesso.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelAllowExternalData

Permite a atualização de dados externos com suporte em pastas de trabalho do Excel em um navegador em que as pastas de trabalho contêm conexões com dados externos. O padrão é True.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelAutomaticVolatileFunctionCacheLifeTime

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.

• -1: Calcula uma vez quando a pasta de trabalho é carregada.
• 0: Sempre calcula.
• 1 a 2073600: Permanece no cache de 1 segundo a 24 dias.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelCachingUnusedFiles

Habilite o cache de arquivos que não estão mais sendo usados por sessões Web do Excel.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelChartAndImageSizeMax

Especifica o tamanho máximo, em megabytes, de um gráfico ou imagem que pode ser aberto pelo Excel em um navegador. O valor deve ser um inteiro maior que 0.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelConcurrentDataRequestsPerSessionMax

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 são colocadas em fila.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelConnectionLifetime

Especifica a duração, em segundos, das conexões de dados externos para o Excel em um navegador. O padrão é 1800 segundos.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelDefaultWorkbookCalcMode

PARAMVALUE: File | Manual | Auto | AutoDataTables

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelExternalDataCacheLifetime

Especifica a duração, em segundos, do tempo de vida do cache de dados externos no Excel em um navegador. O padrão é 300 segundos.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelMemoryCacheThreshold

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 não estão em uso no momento são liberados. Os valores válidos: 0 (desabilita o cache de objetos inativos); de 1 a 95.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelPrivateBytesMax

Especifica o máximo de bytes privados, em megabytes, usados pelo Excel em um navegador. Quando definido como -1, o máximo de bytes privados usa 50 por cento da memória física no computador.

O tipo deve ser -1 ou qualquer inteiro positivo. O valor padrão é -1.

É necessário reiniciar cada servidor no farm para que esta alteração tenha efeito.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelRequestDurationMax

Especifica a duração máxima, em segundos, para uma única solicitação em uma sessão. Após este tempo decorrer, a solicitação expira.

O tipo deve ser -1 (sem limite) ou um inteiro no intervalo de 1 a 2073600. O valor padrão é 300.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelRestExternalDataEnabled

Permitir solicitações da API REST para atualizar conexões de dados externos. Esta configuração não tem efeito se Permitir Dados Externos estiver definido como None. Caixa de seleção Bool. O padrão é False.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelSessionTimeout

Especifica o tempo, em segundos, que uma sessão permanece ativa no Excel em um navegador quando não há 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 A sessão permanece ativa por 1 segundo a 24 dias.

O valor padrão é 450.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelUdfsAllowed

Habilita funções definidas pelo usuário para o Excel em um navegador. O padrão é False.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelUnusedObjectAgeMax

O tempo máximo (em minutos) para os objetos inativos permanecerem no cache de memória. Os objetos inativos são objetos que não são usados em uma sessão.

Valores válidos:

• -1 (sem máximo)
• 1 a 34560 (24 dias).

O padrão é -1.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelUseEffectiveUserName

Permite o uso do parâmetro Analysis Services EffectiveUserName com o Excel em um navegador. O padrão é False.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelWarnOnDataRefresh

Desativa ou ativa a caixa de diálogo de aviso exibida quando os dados são atualizados no Excel em um navegador.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelWorkbookSizeMax

Especifica o tamanho máximo, em megabytes, de uma pasta de trabalho que pode ser carregada.

O tipo deve ser um valor inteiro no intervalo de 1 a 2000. O valor padrão é 10.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExternalURL

Especifica a raiz de URL que os clientes usam para acessar o farm do Servidor do Servidor do Office Online pela Internet. No caso de um farm de Servidor do Office Online com vários servidores com balanceamento de carga, a URL externa é vinculada ao endereço IP do balanceador de carga externo.

Um farm de Servidor do Office Online requer pelo menos uma URL, que é definida usando ExternalURL ou InternalURL. Também é possível definir URLs internas e externas.

Propriedades do parâmetro

Conjuntos de parâmetros

-FarmOU

Especifica o nome da unidade organizacional (OU) do Active Directory da qual os servidores devem ser membros para ingressar no farm do Servidor do Office Online. Use esse parâmetro para impedir que servidores não autorizados (ou seja, servidores que não estão na UO) ingressem em um farm de Servidor do Office Online.

Propriedades do parâmetro

Conjuntos de parâmetros

-Force

Suprime qualquer prompt do usuário respondendo "Sim".

Propriedades do parâmetro

Conjuntos de parâmetros

-InternalURL

Especifica a raiz de URL que os clientes devem usar para acessar o farm do Servidor do Office Online da intranet.

Um farm de Servidor do Office Online requer pelo menos uma URL. Ele é definido usando ExternalURL ou InternalURL. Também é possível definir URLs internas e externas.

Propriedades do parâmetro

Conjuntos de parâmetros

-LogLocation

Especifica o local no computador local onde os logs de atividade são armazenados.

O local é aplicado a cada servidor no farm e não pode ser personalizado de acordo com o servidor. O local padrão é %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS\.

Certifique-se de permitir espaço em disco suficiente no drive onde os logs são armazenados.

É necessário reiniciar cada servidor no farm para que esta alteração tenha efeito.

Propriedades do parâmetro

Conjuntos de parâmetros

-LogRetentionInDays

Especifica o número de dias que as entradas de log são armazenadas. As entradas de logs anteriores à data configurada são cortadas.

O tipo deve ser um valor inteiro no intervalo de 0 a 365. O valor padrão é 7 dias.

É necessário reiniciar cada servidor no farm para que esta alteração tenha efeito.

Propriedades do parâmetro

Conjuntos de parâmetros

-LogVerbosity

Especifica quanta informação é armazenada nos arquivos de log de rastreamento. Os valores são os seguintes:

• VerboseEX grava detalhes de nível baixo no arquivo de log de rastreamento. Útil para rastreamentos que provavelmente terão alto volume.
• Verbose grava detalhes de nível baixo no arquivo de log de rastreamento.
• Medium grava detalhes de nível médio no arquivo de log de rastreamento.
• High grava detalhes de nível alto no arquivo de log de rastreamento.
• Monitorable grava rastreamentos que representam um caminho de código incomum e ações que devem ser monitoradas.
• Unexpected grava rastreamentos que representam um caminho de código inesperado e ações que devem ser monitoradas.
• None não grava nenhuma informação no arquivo de log de rastreamento.

Deixar o LogVerbosity em um nível baixo por um longo período de tempo afetará adversamente o desempenho.

É necessário reiniciar cada servidor no farm para que esta alteração tenha efeito.

Propriedades do parâmetro

Conjuntos de parâmetros

-MaxMemoryCacheSizeInMB

Especifica, em megabytes, a quantidade máxima de memória que o cache de renderização pode usar.

O tipo deve ser um valor inteiro no intervalo de 0 a qualquer inteiro positivo. O valor padrão é 1024 MB.

Propriedades do parâmetro

Conjuntos de parâmetros

-MaxTranslationCharacterCount

Especifica o número máximo de caracteres que um documento pode ter para ser traduzido.

O tipo deve ser um valor inteiro. O valor pode ser definido como 0 para indicar sem limite ou um valor de 2.000 a 2.000.000. O valor padrão é 125.000.

Propriedades do parâmetro

Conjuntos de parâmetros

-OpenFromUncEnabled

Ativa ou desativa o recurso para usar Visualizadores Online para exibir arquivos do Office de um caminho UNC.

Primeiro, você deve definir OpenFromUrlEnabled como True para permitir que os Visualizadores Online exibam arquivos nos caminhos UNC.

Propriedades do parâmetro

Conjuntos de parâmetros

-OpenFromUrlEnabled

Ativa ou desativa a capacidade de usar Visualizadores Online para exibir arquivos do Office por meio de uma URL ou caminho UNC.

Propriedades do parâmetro

Conjuntos de parâmetros

-OpenFromUrlThrottlingEnabled

Acelera o número de solicitações de URL Abrir De a partir de qualquer servidor determinado em um período de tempo. Os valores de limitação padrão, que não são configuráveis, garantem que um farm de Servidor do Office Online não sobrecarregue um único servidor com solicitações de conteúdo a ser exibido nos Visualizadores Online.

Propriedades do parâmetro

Conjuntos de parâmetros

-PicturePasteDisabled

Desativa a capacidade dos usuários de colar imagens de uma página da Web no Office em um navegador. O padrão é False. Se OpenFromURLEnabled estiver definido como True e PicturePasteDisabled não estiver definido como False, os usuários poderão colar imagens no Office em um navegador.

Propriedades do parâmetro

Conjuntos de parâmetros

-Proxy

Especifica o URL do servidor de proxy que é configurado para permitir solicitações HTTP para sites externos. Geralmente configurado em conjunto com os parâmetros ClipartEnabled e TranslationEnabled.

Propriedades do parâmetro

Conjuntos de parâmetros

-RecycleActiveProcessCount

Especifica o número de arquivos que um único processo do Word ou PowerPoint pode renderizar antes de ser reciclado. O tipo deve ser um valor inteiro no intervalo de 1 a 1000. O valor padrão é 5.

É necessário reiniciar cada servidor no farm para que esta alteração tenha efeito.

Propriedades do parâmetro

Conjuntos de parâmetros

-RemovePersonalInformationFromLogs

Fornece uma limpeza de melhor esforço de informações pessoais dos logs do Servidor do Servidor do Office Online e substitui os valores por um hash SHA256. As informações que podem ser limpas podem ser:

• Nome de documentos e URLs
• Endereços IP
• Endereços de email
• Nomes de usuário

O padrão é False. Observe que habilitar esse parâmetro não garante que as informações pessoais não serão registradas nos logs do Servidor do Servidor do Office Online.

Propriedades do parâmetro

Conjuntos de parâmetros

-RenderingLocalCacheLocation

Especifica o local do cache temporário para uso pelos Serviços de Exibição do Word e PowerPoint.

O local padrão é %programdata%\Microsoft\OfficeWebApps\Working\waccache\.

Propriedades do parâmetro

Conjuntos de parâmetros

-S2SCertificateName

O nome amigável do certificado a ser usado para autenticação de servidor para servidor com o SharePoint Server.

Propriedades do parâmetro

Conjuntos de parâmetros

-SSLOffloaded

Indica aos servidores no farm do Servidor do Office Online que o SSL foi descarregado para o balanceador de carga. Quando o SSLOffloaded é habilitado, os aplicativos Web são associados a porta 80 (HTTP) no servidor local. No entanto, o HTML que faz referências a outros recursos, como CSS ou imagens, usa URLs HTTPS para aquelas referências.

É necessário reiniciar cada servidor no farm para que esta alteração tenha efeito.

Propriedades do parâmetro

Conjuntos de parâmetros

-TranslationEnabled

Habilita o suporte para tradução de documento automática usando o Microsoft Translator, um serviço online que traduz texto entre idiomas. O arquivo traduzido é mostrado no Word. Como o Microsoft Translator é um serviço online, você deve habilitar a comunicação servidor para Web diretamente ou usando um proxy especificado usando o parâmetro Proxy.

O Microsoft Translator pode coletar dados para melhorar a qualidade das traduções.

Propriedades do parâmetro

Conjuntos de parâmetros

-TranslationServiceAddress

Especifica a URL do servidor de tradução para o qual as solicitações de tradução são enviadas. O padrão é o serviço online do Microsoft Translator. Geralmente, você não usará esse parâmetro, a menos que precise alterar os serviços de tradução.

Você deve reiniciar todos os servidores no farm do Servidor do Servidor do Office Online para que esta alteração entre em vigor.

Propriedades do parâmetro

Conjuntos de parâmetros

-TranslationServiceAppId

Especifica a ID do aplicativo para o serviço de tradução. O padrão é a ID do aplicativo público para o Office em um navegador. Geralmente, você não usará esse parâmetro, a menos que tenha negociado serviços adicionais com o Microsoft Translator e que eles tenham fornecido uma ID de aplicativo particular a você.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando.

Propriedades do parâmetro

Conjuntos de parâmetros