New-OfficeWebAppsFarm

Cria um novo farm do Servidor do Office Online no computador local.

Syntax

New-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

O cmdlet New-OfficeWebAppsFarm cria um novo farm de Servidor do Office Online no computador local. Execute esse cmdlet no primeiro servidor no farm Servidor do Office Online e adicione mais servidores ao farm usando o cmdlet New-OfficeWebAppsMachine.

Exemplos

------------------EXEMPLO 1---------------------

New-OfficeWebAppsFarm -ExternalUrl "https://office.contoso.com" -CertificateName "Office Server Cert" -EditingEnabled:$true

Este exemplo cria um farm Servidor do Office Online no servidor local que tem a edição habilitada para o Office em um navegador. Com este exemplo, apenas uma ÚNICA URL é usada para usuários internos e externos. O valor Nome do Certificado é o Nome Amigável do certificado, conforme ele aparece no repositório de certificados do Computador.

Parâmetros

-AllowCEIP

Habilita relatórios do CEIP (Programa de Aprimoramento de Experiência do Cliente) em todos os servidores do farm Servidor do Office Online.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowOutboundHttp

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificateName

Especifica o nome amigável do certificado que 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 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClipartEnabled

Habilita o suporte para inserir imagens do Bing 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.

O parâmetro OpenFromUrlEnabled deve ser definido como True para que as imagens do Bing funcionem.. O padrão é False.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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

-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.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelAllowExternalData

Habilita 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelCachingUnusedFiles

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelConnectionLifetime

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelDefaultWorkbookCalcMode

PARAMVALUE: File | Manual | Auto | AutoDataTables

Type:DefaultWorkbookCalcMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelExternalDataCacheLifetime

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelPrivateBytesMax

Especifica os bytes privados máximos, 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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelSessionTimeout

Especifica a hora, 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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelUdfsAllowed

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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); de 1 a 34560 (24 dias). O padrão é -1.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelUseEffectiveUserName

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelWarnOnDataRefresh

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExternalURL

Especifica a raiz de URL que os clientes usam para acessar o farm Servidor do Office Online da Internet. No caso de um farm de Servidor do Office Online multiserver balanceado por carga, a URL externa está vinculada ao endereço IP do balanceador de carga voltado para externo.

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FarmOU

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Suprime qualquer prompt do usuário respondendo Sim.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InternalURL

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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 nível baixo por um longo período de tempo impactará negativamente o desempenho.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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 tamanho padrão é 75 MB.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxTranslationCharacterCount

Especifica a quantidade máxima 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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OpenFromUrlEnabled

Ativa ou desativa a capacidade de usar visualizadores online para exibir arquivos do Office de um caminho de URL ou UNC. O padrão é False.

Você deve definir esse parâmetro como True quando usar ClipartEnabled.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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, verifique se um farm Servidor do Office Online não sobrecarregará um único servidor com solicitações para que o conteúdo seja exibido nos Visualizadores Online.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RecycleActiveProcessCount

Especifica o número de arquivos que um único processo do Word ou do PowerPoint pode renderizar antes que o processo seja reciclado.

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

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemovePersonalInformationFromLogs

Fornece uma melhor limpeza de esforço de informações pessoais de Servidor do Office Online logs 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. Observe que habilitar esse parâmetro não garante que as informações pessoais não sejam registradas nos logs de Servidor do Office Online.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RenderingLocalCacheLocation

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-S2SCertificateName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TranslationServiceAppId

Especifica a ID do aplicativo para o serviço de tradução. O padrão é a ID do aplicativo público do 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ê.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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