Edit

Share via


New-OfficeWebAppsHost

Adds a host ___domain to the Allow List for an Office Online Server farm.

Syntax

Default (Default)

New-OfficeWebAppsHost
    -Domain <String>

Description

The New-OfficeWebAppsHost cmdlet adds a host ___domain to the list of host domains to which Office Online 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 Online Server farm and using it for file operations without your knowledge.

You may any ___domain type including: Public, Pool, Farm, and Active Directory ___domain names. Just make sure that the ___domain you're granting access to meets your security requirements.

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

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

Examples

EXAMPLE 1

New-OfficeWebAppsHost -___domain "contoso.com"

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

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.

Parameters

-Domain

Specifies the ___domain to add to the Allow List. Do not specify an asterisk or start it with a period.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False