This topic has not yet been rated - Rate this topic

New-OfficeWebAppsHost

Office Web Apps

Published: July 16, 2012

Applies to: Office Web Apps Server

Adds a host domain to the Allow List for an Office Web Apps Server farm.

New-OfficeWebAppsHost -Domain <String>

Parameters

Parameter	Required	Type	Description
Domain	Required	System.String	Specifies the domain to add to the Allow List. Do not specify an asterisk or start it with a period.

Detailed Description

The New-OfficeWebAppsHost cmdlet adds a host domain to the list of host domains to which Office Web Apps Server allows file operations requests, such as file retrieval, metadata retrieval, and file changes. This list, known as the Allow List, is a security feature that prevents unwanted hosts from connecting to an Office Web Apps Server farm and using it for file operations without your knowledge.

The wildcard * is assumed for any domain that is added to the Allow List so that requests to all subdomains are also allowed. For example, if you add the domain contoso.com to the Allow List, Office Web Apps Server also allows requests to the domains corp.contoso.com and dev.contoso.com. Requests to other domains (such as fabrikam.com) are not allowed.

Caution:
If there are no domains on the Allow List, Office Web Apps Server allows file requests to hosts in any domain. Do not leave this list blank if your Office Web Apps Server farm is accessible from the Internet. Otherwise anyone can use your Office Web Apps Server farm to view and edit content.

Input Types

Return Types

Example

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

New-OfficeWebAppsHost –domain “contoso.com”

This example adds the domain contoso.com to the Allow List.

Note:
You cannot add multiple host domains to the Allow List all at the same time. You must run the New-OfficeWebAppsHost cmdlet for each host domain that you want to add to the Allow List.