Set-OfficeWebAppsFarm

Sintaxe

Default (Padrão)

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

Ativa os relatórios do Programa de Melhoramento da Experiência do Cliente (PMEC) em todos os servidores no farm de Servidor do Office Online.

Tem de reiniciar todos os servidores no farm de 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 aprovisionados 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 ligações HTTP de saída a partir de 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. A localização predefinida é %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 Servidor do Office Online utiliza para criar enlaces 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.

Este valor é utilizado em todos os servidores que se associam ao farm de Servidor do Office Online. Portanto, cada servidor no farm deve ter um certificado que possui este nome amigável.

Não tem de especificar o parâmetro CertificateName se estiver a utilizar 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

Permite o suporte para inserir ClipArt 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

Ativa a atualização de dados externos suportados em livros do Excel num browser onde os livros contêm ligações a 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 num browser. 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 ligações de dados externos para o Excel num browser. 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, da duração da cache de dados externos no Excel num browser. 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, utilizados pelo Excel num browser. 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 a hora, em segundos, de que uma sessão permanece ativa no Excel num browser quando não existe 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 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

Ativa as Funções Definidas pelo Utilizador para o Excel num browser. 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 a utilização do parâmetro EffectiveUserName do Analysis Services com o Excel num browser. O padrão é False.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcelWarnOnDataRefresh

Desativa ou na caixa de diálogo de aviso que é apresentada quando os dados são atualizados no Excel num browser.

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 utilizam para aceder ao farm de Servidor do Office Online a partir da Internet. No caso de um farm de Servidor do Office Online multiservidor com balanceamento de carga, o URL externo está vinculado ao endereço IP do balanceador de carga com acesso externo.

Um farm de Servidor do Office Online requer, pelo menos, um URL, que é conjunto com 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 (UO) do Active Directory de que os servidores têm de ser membros para aderir ao farm de Servidor do Office Online. Utilize este parâmetro para impedir que servidores não autorizados (ou seja, servidores que não estão na UO) se assocedam a 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 têm de utilizar para aceder ao farm de Servidor do Office Online a partir da intranet.

Um farm de Servidor do Office Online necessita de, pelo menos, um URL. É definido com 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. A localização predefinida é %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 utilizar Visualizadores Online para ver ficheiros do Office a partir de um caminho DE URL ou 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 predefinidos, que não são configuráveis, garantem que um farm de Servidor do Office Online não sobrecarregará um único servidor com pedidos de conteúdo a serem visualizados nos Visualizadores Online.

Propriedades do parâmetro

Conjuntos de parâmetros

-PicturePasteDisabled

Desativa a capacidade de os utilizadores colarem imagens de uma página Web no Office num browser. O padrão é False. Se OpenFromURLEnabled estiver definido como Verdadeiro e PicturePasteDisabled não estiver definido ou definido como Falso, os utilizadores podem colar imagens no Office num browser.

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 ficheiros que um único Word ou processo do PowerPoint pode compor antes de o processo 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 melhor limpeza de informações pessoais de Servidor do Office Online registos e substitui 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. Tenha em atenção que ativar este parâmetro não garante que as informações pessoais não sejam registadas nos registos de Servidor do Office Online.

Propriedades do parâmetro

Conjuntos de parâmetros

-RenderingLocalCacheLocation

Especifica a localização da cache temporária para utilização pelo Word e pelos Serviços de Visualização do PowerPoint.

A localização predefinida é %programdata%\Microsoft\OfficeWebApps\Working\waccache\.

Propriedades do parâmetro

Conjuntos de parâmetros

-S2SCertificateName

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

Propriedades do parâmetro

Conjuntos de parâmetros

-SSLOffloaded

Indica aos servidores no farm Servidor do Office Online que o SSL é 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 ficheiro traduzido é apresentado 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.

Tem de reiniciar todos os servidores no farm de 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. A predefinição é o ID da aplicação pública para o Office num browser. 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