Export (0) Print
Expand All

Set-OfficeWebAppsMachine

Office Web Apps

Published: July 16, 2012

Applies to:  Office Web Apps Server 

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

Parameters

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

Important Important:

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

Detailed Description

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.

Input Types

Return Types

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