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 |