adding new cmdlets for Tenant Default Configuration on Telephone Numbers

teams/teams-ps/MicrosoftTeams/Get-CsPhoneNumberTenantConfiguration.md

@@ -0,0 +1,99 @@
+---
+applicable: Microsoft Teams
+author: pavellatif
+external help file: Microsoft.Teams.ConfigAPI.Cmdlets-help.xml
+Locale: en-US
+manager: roykuntz
+Module Name: MicrosoftTeams
+ms.author: pavellatif
+ms.reviewer: pavellatif
+online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-csphonenumbertenantconfiguration
+schema: 2.0.0
+title: Get-CsPhoneNumberTenantConfiguration
+---
+
+# Get-CsPhoneNumberTenantConfiguration
+
+## SYNOPSIS
+This cmdlet displays existing tenant level telephone number default configurations.
+
+## SYNTAX
+
+```
+Get-CsPhoneNumberTenantConfiguration [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+This cmdlet displays existing tenant level telephone number default configurations.
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> Get-CsPhoneNumberTenantConfiguration
+```
+```output
+AssignmentEmailEnabled        : True
+UnassignmentEmailEnabled      : True
+AssignmentBlockedForever      :
+AssignmentBlockedDays         :
+AllowOnPremToOnlineMigration  : 
+TenantId                      : 407c17ae-8c41-431e-894a-38787c682f68
+```
+
+This example that email notifications are enabled for any telephone number assignment and unassignment operations. End users will receive an email about the change unless configuration is overridden during assignment or unassignment operations. 
+
+### Example 2
+```powershell
+PS C:\> Get-CsPhoneNumberTenantConfiguration
+```
+```output
+AssignmentEmailEnabled        : False
+UnassignmentEmailEnabled      : False
+AssignmentBlockedForever      : True
+AssignmentBlockedDays         :
+AllowOnPremToOnlineMigration  : 
+TenantId                      : 407c17ae-8c41-431e-894a-38787c682f68
+```
+
+This example displays that both email notifications and AssignmentBlockedForever is set by default. If a telephone number is unassigned, an email is sent to end user and the number is blocked from new assignment until the [block is manually removed](https://learn.microsoft.com/powershell/module/microsoftteams/remove-csphonenumberassignmentblock?view=teams-ps).
+
+
+## PARAMETERS
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### AssignmentEmailEnabled
+
+Boolean stating if email notifications would be sent for telephone number assignment operations.
+
+### UnassignmentEmailEnabled
+
+Boolean stating if email notifications would be sent for telephone number unassignment operations.
+
+### AssignmentBlockedForever
+
+Boolean stating if assignment is blocked indefinitely.
+
+### AssignmentBlockedDays
+
+The number of days that assignment is blocked.
+
+### AllowOnPremToOnlineMigration
+
+Boolean stating if migrating Direct Routing numbers from OnPremises to Online is supported.
+
+## NOTES
+
+## RELATED LINKS
+
+- [Remove-CsPhoneNumberTenantConfiguration](Remove-CsPhoneNumberTenantConfiguration.md)
+- [Set-CsPhoneNumberTenantConfiguration](Set-CsPhoneNumberTenantConfiguration.md)

teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md

@@ -263,6 +263,9 @@ This cmdlet retrieves policy assignments associated with a specific telephone nu
 ### [Get-CsPhoneNumberTag](Get-CsPhoneNumberTag.md)
 This cmdlet allows the admin to get a list of existing tags for telephone numbers.
 
+### [Get-CsPhoneNumberTenantConfiguration](Get-CsPhoneNumberTenantConfiguration.md)
+This cmdlet displays existing tenant level telephone number default configurations.
+
 ### [Get-CsPolicyPackage](Get-CsPolicyPackage.md)
 This cmdlet supports retrieving all the policy packages available on a tenant.
 
@@ -1199,6 +1202,9 @@ This cmdlet allows the admin to remove an assignment block on a telephone number
 ### [Remove-CsPhoneNumberTag](Remove-CsPhoneNumberTag.md)
 This cmdlet allows admin to remove a tag from phone number.
 
+### [Remove-CsPhoneNumberTenantConfiguration](Remove-CsPhoneNumberTenantConfiguration.md)
+This cmdlet allows the admins to remove a tenant default configuration that applies to all telephone numbers within the tenant.
+
 ### [Remove-CsTeamsRemoteLogCollectionDevice](Remove-CsTeamsRemoteLogCollectionDevice.md)
 This cmdlet will remove/delete a device from the remote log collection configuration.
 
@@ -1514,6 +1520,9 @@ This cmdlet assigns a policy to a specific telephone number in Microsoft Teams.
 ### [Set-CsPhoneNumberTag](Set-CsPhoneNumberTag.md)
 This cmdlet allows the admin to create and assign a tag to a phone number.
 
+### [Set-CsPhoneNumberTenantConfiguration](Set-CsPhoneNumberTenantConfiguration.md)
+This cmdlet allows the admins to set a tenant default configuration that applies to all telephone numbers within the tenant.
+
 ### [Set-CsTeamsRemoteLogCollectionDevice](Set-CsTeamsRemoteLogCollectionDevice.md)
 This cmdlet allows the admin to create and edit a device requested for remote log collection.
 

teams/teams-ps/MicrosoftTeams/Remove-CsPhoneNumberTenantConfiguration.md

@@ -0,0 +1,141 @@
+---
+applicable: Microsoft Teams
+author: pavellatif
+external help file: Microsoft.Teams.ConfigAPI.Cmdlets-help.xml
+Locale: en-US
+manager: roykuntz
+Module Name: MicrosoftTeams
+ms.author: pavellatif
+ms.reviewer: pavellatif
+online version: https://learn.microsoft.com/powershell/module/microsoftteams/remove-csphonenumbertenantconfiguration
+schema: 2.0.0
+title: Remove-CsPhoneNumberTenantConfiguration
+---
+
+# Remove-CsPhoneNumberTenantConfiguration
+
+## SYNOPSIS
+This cmdlet allows the admins to remove a tenant default configuration that applies to all telephone numbers within the tenant.
+
+## SYNTAX
+
+```
+Remove-CsPhoneNumberTenantConfiguration [-AssignmentEmailEnabled] [-UnassignmentEmailEnabled] [-AssignmentBlockedForever] [-AssignmentBlockedDays] [-AllowOnPremToOnlineMigration]
+[<CommonParameters>]
+```
+
+## DESCRIPTION
+
+This cmdlet allows the teams phone administrators to remove a tenant default configuration that applies to all the telephone numbers within the tenant. 
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> Remove-CsPhoneNumberTenantConfiguration -AssignmentEmailEnabled -UnassignmentEmailEnabled
+```
+
+The above example shows how to remove email notification configuration setting for all the telephone number assignment and unassignment operations within the tenant.
+
+### Example 2
+```powershell
+PS C:\> Remove-CsPhoneNumberTenantConfiguration -AssignmentBlockedForever
+```
+
+The above example shows how to remove the indefinite assignment block configuration for all the telephone numbers within the tenant.
+
+
+## PARAMETERS
+
+### -AssignmentEmailEnabled
+Indicates the assignment email notification configuration will be removed.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -UnassignmentEmailEnabled
+Indicates the unassignment email notification configuration will be removed.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -AssignmentBlockedForever
+Indicates the assignment blocked forever configuration will be removed.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -AssignmentBlockedDays
+Indicates the assignment blocked days configuration will be removed.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -AllowOnPremToOnlineMigration
+Indicates the configuration will be removed for allowing OnPremises direct routing numbers to be automatically migrated to online direct routing numbers if an online operation is performed.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### None
+
+## NOTES
+
+## RELATED LINKS
+
+- [Set-CsPhoneNumberTenantConfiguration](Set-CsPhoneNumberTenantConfiguration.md)
+- [Get-CsPhoneNumberTenantConfiguration](Get-CsPhoneNumberTenantConfiguration.md)