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 |