Export (0) Print
Expand All

Set-OfficeWebAppsMachine

Office Web Apps
 

Applies to: Office Web Apps Server

Topic Last Modified: 2013-12-18

Changes the settings of the current server that is in an Office Web Apps Server farm.

Set-OfficeWebAppsMachine [-Confirm [<SwitchParameter>]] [-Master <String>] [-Roles <String[]>] [-WhatIf [<SwitchParameter>]]

The Set-OfficeWebAppsMachine cmdlet changes the settings of the current server that is in an Office Web Apps Server farm. The settings include the roles held by the current server and the designated master server for the farm.

 

Parameter Required Type Description

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command. For more information, type the following command: get-help about_commonparameters

Master

Optional

System.String

Specifies the server that stores the master farm configuration files.

If you set the local server as the master, you must run Set-OfficeWebAppsMachine -Master on all of the remaining servers in the Office Web Apps Server farm to point them to the new master.

Roles

Optional

System.String[]

Specifies the list of server roles to assign to the local server, separated by commas.

The role types are as follows:

All

FrontEnd

WordBackEnd

ExcelBackEnd

PowerPointBackEnd

ImportantImportant:
As a best practice, we recommend that all servers in an Office Web Apps Server farm run all roles. Assigning roles is not useful until the Office Web Apps Server farm contains approximately 50 servers.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

------------------EXAMPLE 1---------------------

(Get-OfficeWebAppsFarm).Machines

This example shows the roles held by each server in the Office Web Apps Server farm.

------------------EXAMPLE 2---------------------

Set-OfficeWebAppsMachine -Roles FrontEnd

This example configures the current server as a Front End server.

------------------EXAMPLE 3---------------------

Set-OfficeWebAppsMachine -Roles All

This example configures the current server to host all roles.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft