Add documentation about BlockAllSubdomains param

This param was implemented for Federation Settings.

Author: andreimaneev

skype/skype-ps/skype/Set-CsTenantFederationConfiguration.md

@@ -20,16 +20,17 @@ These settings are used to determine which domains (if any) your users are allow
 
 ### Identity (Default)
 ```
-Set-CsTenantFederationConfiguration [-Tenant <Guid>] [-AllowedDomains <IAllowedDomainsChoice>]
- [-BlockedDomains <List>] [-AllowFederatedUsers <Boolean>] [-AllowPublicUsers <Boolean>] [-AllowTeamsConsumer <Boolean>] [-AllowTeamsConsumerInbound <Boolean>]
+Set-CsTenantFederationConfiguration [-Tenant <Guid>]
+ [-AllowedDomains <IAllowedDomainsChoice>] [-BlockedDomains <List>] [-BlockAllSubdomains <Boolean>]
+ [-AllowFederatedUsers <Boolean>] [-AllowPublicUsers <Boolean>] [-AllowTeamsConsumer <Boolean>] [-AllowTeamsConsumerInbound <Boolean>]
  [-TreatDiscoveredPartnersAsUnverified <Boolean>] [-SharedSipAddressSpace <Boolean>]
  [-AllowedDomainsAsAList <List>] [[-Identity] <XdsIdentity>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ### Instance
 ```
 Set-CsTenantFederationConfiguration [-Tenant <Guid>] [-AllowedDomains <IAllowedDomainsChoice>]
- [-BlockedDomains <List>] [-AllowFederatedUsers <Boolean>] [-AllowPublicUsers <Boolean>]
+ [-BlockedDomains <List>] [-BlockAllSubdomains <Boolean>] [-AllowFederatedUsers <Boolean>] [-AllowPublicUsers <Boolean>]
  [-TreatDiscoveredPartnersAsUnverified <Boolean>] [-SharedSipAddressSpace <Boolean>]
  [-AllowedDomainsAsAList <List>] [-Instance <PSObject>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
@@ -150,6 +151,15 @@ Set-CsTenantFederationConfiguration -AllowTeamsConsumer $True -AllowTeamsConsume
 
 The command shown in Example 9 enables communication with people using Teams with an account that's not managed by an organization, to only be initiated by people in your organization. This means that people using Teams with an account that's not managed by an organization will not be able to discover or start a conversation with people in your organization.
 
+### -------------------------- Example 10 -------------------------
+```
+Set-CsTenantFederationConfiguration -BlockAllSubdomains $True
+```
+
+Example 10 shows how you can empower BlockedDomains to also block all subdomains.
+Let's say you block contoso.com. Then all users from subdomain.contoso.com will also be blocked.
+Note: Users from subcontoso.com will not be blocked because it's a completely different domain rather than a subdomain.
+
 ## PARAMETERS
 
 ### -AllowedDomains
@@ -256,6 +266,25 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -BlockAllSubdomains
+If the BlockedDomains parameter is used, then BlockAllSubdomains can be used to activate all subdomains blocking.
+If the BlockedDomains parameter is ignored, then BlockAllSubdomains is also ignored.
+Just like for BlockedDomains, users will be disallowed from communicating with users from blocked domains.
+But all subdomains for domains in this list will also be blocked.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: 
+Applicable: Skype for Business Online
+
+Required: False
+Position: Named
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Confirm
 Prompts you for confirmation before executing the command.