Merge branch 'master' into patch-1

Author: tiburd

skype/skype-ps/skype/New-CsTeamsCallParkPolicy.md

@@ -23,8 +23,7 @@ NOTE: The call park feature currently available in desktop. mobile and web clien
 
 ### Identity (Default)
 ```
-New-CsTeamsCallParkPolicy [-Tenant <System.Guid>] [-AllowCallPark <Boolean>] [[-Identity] <XdsIdentity>]
- [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
+New-CsTeamsCallParkPolicy [-Tenant <System.Guid>] [-AllowCallPark <Boolean>] [[-Identity] <XdsIdentity>] [-PickupRangeStart <Integer>] [-PickupRangeEnd <Integer>] [-ParkTimeoutSeconds <Integer>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -35,10 +34,24 @@ The TeamsCallParkPolicy controls whether or not users are able to leverage the c
 
 ### Example 1
 ```powershell
-PS C:\> New-CsTeamsCallParkPolicy -Identity "SalesPolicy" -AllowCallPark $false
+PS C:\> New-CsTeamsCallParkPolicy -Identity "SalesPolicy" -AllowCallPark $true
 ```
 
-Create a new custom policy that has call park enabled.  This policy can then be assigned to individual users.
+Create a new custom policy that has call park enabled. This policy can then be assigned to individual users.
+
+### Example 2
+```powershell
+PS C:\> New-CsTeamsCallParkPolicy -Identity "SalesPolicy" -AllowCallPark $true -PickupRangeStart 500 -PickupRangeEnd 1500
+```
+
+Create a new custom policy that has call park enabled. This policy will generate pickup numbers starting from 500 and up until 1500.
+
+### Example 3
+```powershell
+PS C:\> New-CsTeamsCallParkPolicy -Identity "SalesPolicy" -AllowCallPark $true -ParkTimeoutSeconds 600
+```
+
+Create a new custom call park policy which will ring back the parker after 600 seconds if the parked call is unanswered
 
 ## PARAMETERS
 
@@ -102,6 +115,55 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -PickupRangeEnd
+Specify the maximum value that a rendered pickup code can take. Value can be from 10 to 9999.
+
+Note: PickupRangeStart must be smaller than PickupRangeEnd.
+
+```yaml
+Type: Integer
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: 99
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ParkTimeoutSeconds
+Specify the number of seconds to wait before ringing the parker when the parked call hasn't been picked up. Value can be from 120 to 1800 (seconds).
+
+```yaml
+Type: Integer
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: 300
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -PickupRangeStart
+Specify the minimum value that a rendered pickup code can take. Value can be from 10 to 9999.
+
+Note: PickupRangeStart must be smaller than PickupRangeEnd.
+
+```yaml
+Type: Integer
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: 10
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Tenant
 Internal Microsoft use only.
 
@@ -133,6 +195,7 @@ 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 (https://go.microsoft.com/fwlink/?LinkID=113216).

skype/skype-ps/skype/Remove-CsOnlineTelephoneNumber.md

@@ -1,53 +1,70 @@
 ---
 external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml 
 online version: https://docs.microsoft.com/powershell/module/skype/remove-csonlinetelephonenumber
-applicable: Skype for Business Online
+applicable: Skype for Business Online, Microsoft Teams
 title: Remove-CsOnlineTelephoneNumber
 schema: 2.0.0
 manager: bulenteg
-author: tomkau
-ms.author: tomkau
+author: jenstrier
+ms.author: jenstr
 ms.reviewer:
 ---
 
 # Remove-CsOnlineTelephoneNumber
 
 ## SYNOPSIS
-Use the `Remove-CsOnlineTelephoneNumber` cmdlet to remove a telephone number from the Business Voice Directory.
+Use the `Remove-CsOnlineTelephoneNumber` cmdlet to remove one or more unassigned telephone numbers from your tenant.
 
 ## SYNTAX
 
 ```
-Remove-CsOnlineTelephoneNumber -TelephoneNumber <String[]> [-Tenant <Guid>] [-DomainController <Fqdn>]
- [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
+Remove-CsOnlineTelephoneNumber -TelephoneNumber <String[]> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
-Provide the detailed description here.
+This cmdlet removes one or more unassigned telephone numbers from your tenant. If at least one of the telephone numbers is assigned to a user or resource account, the cmdlet will fail and will not remove any of the specified telephone numbers.
 
 ## EXAMPLES
 
 ### -------------------------- Example 1 --------------------------
 ```
-Remove-CsOnlineTelephoneNumber -TelephoneNumber +14258884567
+Remove-CsOnlineTelephoneNumber -TelephoneNumber 14258884567
+```
+```Output
+NumberIdsDeleted NumberIdsDeleteFailed NumberIdsNotOwnedByTenant NumberIdsManagedByServiceDesk
+---------------- --------------------- ------------------------- -----------------------------
+{14258884567}    {}                    {}                        {}
+```
+
+This example removes the specified telephone number from the tenant.
+
+### -------------------------- Example 2 --------------------------
+```
+[string[]]$tns="+14255551234","+14255551233"
+Remove-CsOnlineTelephoneNumber -TelephoneNumber $tns
+```
+```Output
+NumberIdsDeleted NumberIdsDeleteFailed NumberIdsNotOwnedByTenant NumberIdsManagedByServiceDesk
+---------------- --------------------- ------------------------- -----------------------------
+{14255551234,     {}                    {}                        {}
+ 14255551233}    
 ```
 
-This example removes the specified telephone number from the Business Voice Directory.
+This example removes the specified list of telephone numbers from the tenant.
 
 
 ## PARAMETERS
 
 ### -TelephoneNumber
-Specifies the target telephone number.
-For example: -TelephoneNumber tel:+18005551234, or -TelephoneNumber +14251234567
+Specifies the telephone number(s) to remove. The format can be withor without the prefixed +, but needs to include country code etc.
 
 ```yaml
 Type: String[]
 Parameter Sets: (All)
 Aliases: 
-Applicable: Skype for Business Online
+Applicable: Skype for Business Online, Microsoft Teams
 
-Required: False
+Required: True
 Position: Named
 Default value: None
 Accept pipeline input: False
@@ -61,23 +78,7 @@ The Confirm switch causes the command to pause processing and requires confirmat
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases: cf
-Applicable: Skype for Business Online
-
-Required: False
-Position: Named
-Default value: None
-Accept pipeline input: False
-Accept wildcard characters: False
-```
-
-### -DomainController
-This parameter is reserved for internal Microsoft use.
-
-```yaml
-Type: Fqdn
-Parameter Sets: (All)
-Aliases: DC
-Applicable: Skype for Business Online
+Applicable: Skype for Business Online, Microsoft Teams
 
 Required: False
 Position: Named
@@ -95,23 +96,7 @@ If the Force switch isn't provided in the command, you're prompted for administr
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases: 
-Applicable: Skype for Business Online
-
-Required: False
-Position: Named
-Default value: None
-Accept pipeline input: False
-Accept wildcard characters: False
-```
-
-### -Tenant
-This parameter is reserved for internal Microsoft use.
-
-```yaml
-Type: Guid
-Parameter Sets: (All)
-Aliases: 
-Applicable: Skype for Business Online
+Applicable: Skype for Business Online, Microsoft Teams
 
 Required: False
 Position: Named
@@ -128,7 +113,7 @@ By using this switch, you can view what changes would occur without having to co
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases: wi
-Applicable: Skype for Business Online
+Applicable: Skype for Business Online, Microsoft Teams
 
 Required: False
 Position: Named
@@ -151,6 +136,7 @@ None
 None
 
 ## NOTES
+If one or more of the telephone numbers are assigned to a user or a service, the cmdlet will display an error message and none of the telephone numbers specified will be removed from your tenant.
 
 ## RELATED LINKS
-
+- [Get-CsOnlineTelephoneNumber](Get-CsOnlineTelephoneNumber.md)

skype/skype-ps/skype/Set-CsTeamsCallParkPolicy.md

@@ -22,7 +22,7 @@ NOTE: The call park feature currently available in desktop, mobile, and web clie
 
 ### Identity (Default)
 ```
-Set-CsTeamsCallParkPolicy [-Tenant <System.Guid>] [-AllowCallPark <Boolean>] [[-Identity] <XdsIdentity>]
+Set-CsTeamsCallParkPolicy [-Tenant <System.Guid>] [-AllowCallPark <Boolean>] [-PickupRangeStart <Integer>] [-PickupRangeEnd <Integer>] [-ParkTimeoutSeconds <Integer>] [[-Identity] <XdsIdentity>]
  [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
@@ -44,6 +44,20 @@ PS C:\> Set-CsTeamsCallParkPolicy -Identity SalesPolicy -AllowCallPark $true
 
 Update the existing policy "SalesPolicy" to enable the call park feature.
 
+### Example 2
+```powershell
+PS C:\> Set-CsTeamsCallParkPolicy -Identity "SalesPolicy" -PickupRangeStart 500 -PickupRangeEnd 1500
+```
+
+Update the existing policy "SalesPolicy" to generate pickup numbers starting from 500 and up until 1500.
+
+### Example 3
+```powershell
+PS C:\> New-CsTeamsCallParkPolicy -Identity "SalesPolicy" -ParkTimeoutSeconds 600
+```
+
+Update the existing policy "SalesPolicy" to ring back the parker after 600 seconds if the parked call is unanswered
+
 ## PARAMETERS
 
 ### -AllowCallPark
@@ -121,6 +135,55 @@ Accept pipeline input: True (ByValue)
 Accept wildcard characters: False
 ```
 
+### -PickupRangeEnd
+Specify the maximum value that a rendered pickup code can take. Value can be from 10 to 9999.
+
+Note: PickupRangeStart must be smaller than PickupRangeEnd.
+
+```yaml
+Type: Integer
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: 99
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ParkTimeoutSeconds
+Specify the number of seconds to wait before ringing the parker when the parked call hasn't been picked up. Value can be from 120 to 1800 (seconds).
+
+```yaml
+Type: Integer
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: 300
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -PickupRangeStart
+Specify the minimum value that a rendered pickup code can take. Value can be from 10 to 9999.
+
+Note: PickupRangeStart must be smaller than PickupRangeEnd.
+
+```yaml
+Type: Integer
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: 10
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Tenant
 Internal Microsoft use only.