Skip to content

Commit e5ea212

Browse files
authored
Merge branch 'master' into patch-9
2 parents e7090cc + 4adc7f9 commit e5ea212

File tree

4 files changed

+320
-51
lines changed

4 files changed

+320
-51
lines changed
Lines changed: 35 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,53 +1,70 @@
11
---
22
external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml
33
online version: https://docs.microsoft.com/powershell/module/skype/remove-csonlinetelephonenumber
4-
applicable: Skype for Business Online
4+
applicable: Skype for Business Online, Microsoft Teams
55
title: Remove-CsOnlineTelephoneNumber
66
schema: 2.0.0
77
manager: bulenteg
8-
author: tomkau
9-
ms.author: tomkau
8+
author: jenstrier
9+
ms.author: jenstr
1010
ms.reviewer:
1111
---
1212

1313
# Remove-CsOnlineTelephoneNumber
1414

1515
## SYNOPSIS
16-
Use the `Remove-CsOnlineTelephoneNumber` cmdlet to remove a telephone number from the Business Voice Directory.
16+
Use the `Remove-CsOnlineTelephoneNumber` cmdlet to remove one or more unassigned telephone numbers from your tenant.
1717

1818
## SYNTAX
1919

2020
```
21-
Remove-CsOnlineTelephoneNumber -TelephoneNumber <String[]> [-Tenant <Guid>] [-DomainController <Fqdn>]
22-
[-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
21+
Remove-CsOnlineTelephoneNumber -TelephoneNumber <String[]> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
2322
```
2423

2524
## DESCRIPTION
26-
Provide the detailed description here.
25+
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.
2726

2827
## EXAMPLES
2928

3029
### -------------------------- Example 1 --------------------------
3130
```
32-
Remove-CsOnlineTelephoneNumber -TelephoneNumber +14258884567
31+
Remove-CsOnlineTelephoneNumber -TelephoneNumber 14258884567
32+
```
33+
```Output
34+
NumberIdsDeleted NumberIdsDeleteFailed NumberIdsNotOwnedByTenant NumberIdsManagedByServiceDesk
35+
---------------- --------------------- ------------------------- -----------------------------
36+
{14258884567} {} {} {}
37+
```
38+
39+
This example removes the specified telephone number from the tenant.
40+
41+
### -------------------------- Example 2 --------------------------
42+
```
43+
[string[]]$tns="+14255551234","+14255551233"
44+
Remove-CsOnlineTelephoneNumber -TelephoneNumber $tns
45+
```
46+
```Output
47+
NumberIdsDeleted NumberIdsDeleteFailed NumberIdsNotOwnedByTenant NumberIdsManagedByServiceDesk
48+
---------------- --------------------- ------------------------- -----------------------------
49+
{14255551234, {} {} {}
50+
14255551233}
3351
```
3452

35-
This example removes the specified telephone number from the Business Voice Directory.
53+
This example removes the specified list of telephone numbers from the tenant.
3654

3755

3856
## PARAMETERS
3957

4058
### -TelephoneNumber
41-
Specifies the target telephone number.
42-
For example: -TelephoneNumber tel:+18005551234, or -TelephoneNumber +14251234567
59+
Specifies the telephone number(s) to remove. The format can be withor without the prefixed +, but needs to include country code etc.
4360

4461
```yaml
4562
Type: String[]
4663
Parameter Sets: (All)
4764
Aliases:
48-
Applicable: Skype for Business Online
65+
Applicable: Skype for Business Online, Microsoft Teams
4966

50-
Required: False
67+
Required: True
5168
Position: Named
5269
Default value: None
5370
Accept pipeline input: False
@@ -61,23 +78,7 @@ The Confirm switch causes the command to pause processing and requires confirmat
6178
Type: SwitchParameter
6279
Parameter Sets: (All)
6380
Aliases: cf
64-
Applicable: Skype for Business Online
65-
66-
Required: False
67-
Position: Named
68-
Default value: None
69-
Accept pipeline input: False
70-
Accept wildcard characters: False
71-
```
72-
73-
### -DomainController
74-
This parameter is reserved for internal Microsoft use.
75-
76-
```yaml
77-
Type: Fqdn
78-
Parameter Sets: (All)
79-
Aliases: DC
80-
Applicable: Skype for Business Online
81+
Applicable: Skype for Business Online, Microsoft Teams
8182

8283
Required: False
8384
Position: Named
@@ -95,23 +96,7 @@ If the Force switch isn't provided in the command, you're prompted for administr
9596
Type: SwitchParameter
9697
Parameter Sets: (All)
9798
Aliases:
98-
Applicable: Skype for Business Online
99-
100-
Required: False
101-
Position: Named
102-
Default value: None
103-
Accept pipeline input: False
104-
Accept wildcard characters: False
105-
```
106-
107-
### -Tenant
108-
This parameter is reserved for internal Microsoft use.
109-
110-
```yaml
111-
Type: Guid
112-
Parameter Sets: (All)
113-
Aliases:
114-
Applicable: Skype for Business Online
99+
Applicable: Skype for Business Online, Microsoft Teams
115100

116101
Required: False
117102
Position: Named
@@ -128,7 +113,7 @@ By using this switch, you can view what changes would occur without having to co
128113
Type: SwitchParameter
129114
Parameter Sets: (All)
130115
Aliases: wi
131-
Applicable: Skype for Business Online
116+
Applicable: Skype for Business Online, Microsoft Teams
132117

133118
Required: False
134119
Position: Named
@@ -151,6 +136,7 @@ None
151136
None
152137
153138
## NOTES
139+
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.
154140
155141
## RELATED LINKS
156-
142+
- [Get-CsOnlineTelephoneNumber](Get-CsOnlineTelephoneNumber.md)

skype/skype-ps/skype/Set-CsTeamsCallingPolicy.md

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,12 +20,12 @@ Use this cmdlet to update values in existing Teams Calling Policies.
2020

2121
### Identity (Default)
2222
```
23-
Set-CsTeamsCallingPolicy [-Tenant <System.Guid>] [-AllowWebPSTNCalling <Boolean>] [-SafeTransferEnabled <Object>] [-AllowCalling <Boolean>] [-AllowPrivateCalling <Boolean>] [-AllowVoicemail <String>] [-AllowCallGroups <Boolean>] [-AllowDelegation <Boolean>] [-AllowCallForwardingToUser <Boolean>] [-AllowCallForwardingToPhone <Boolean>] [-AllowCloudRecordingForCalls <Boolean>] [-PreventTollBypass <Boolean>] [-BusyOnBusyEnabledType <String>] [-MusicOnHoldEnabledType <Enum>] [-AutoAnswerEnabledType <Enum>] [[-Identity] <XdsIdentity>] [-AllowTranscriptionForCalling <Boolean>] [-Description <String>] [-LiveCaptionsEnabledTypeForCalling <String>] [-SpamFilteringEnabledType <String>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
23+
Set-CsTeamsCallingPolicy [-Tenant <System.Guid>] [-AllowWebPSTNCalling <Boolean>] [-SafeTransferEnabled <Object>] [-AllowCalling <Boolean>] [-AllowPrivateCalling <Boolean>] [-AllowVoicemail <String>] [-AllowCallGroups <Boolean>] [-AllowDelegation <Boolean>] [-AllowCallForwardingToUser <Boolean>] [-AllowCallForwardingToPhone <Boolean>] [-AllowCloudRecordingForCalls <Boolean>] [-PreventTollBypass <Boolean>] [-AllowSIPDevicesCalling <Boolean>] [-BusyOnBusyEnabledType <String>] [-MusicOnHoldEnabledType <Enum>] [-AutoAnswerEnabledType <Enum>] [[-Identity] <XdsIdentity>] [-AllowTranscriptionForCalling <Boolean>] [-Description <String>] [-LiveCaptionsEnabledTypeForCalling <String>] [-SpamFilteringEnabledType <String>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
2424
```
2525

2626
### Instance
2727
```
28-
Set-CsTeamsCallingPolicy [-Tenant <System.Guid>] [-AllowCalling <Boolean>] [-AllowPrivateCalling <Boolean>] [-AllowVoicemail <String>] [-AllowCallGroups <Boolean>] [-AllowDelegation <Boolean>] [-AllowCallForwardingToUser <Boolean>] [-AllowCallForwardingToPhone <Boolean>] [-AllowCloudRecordingForCalls <Boolean>] [-PreventTollBypass <Boolean>] [-BusyOnBusyEnabledType <String>] [-MusicOnHoldEnabledType <Enum>] [-AutoAnswerEnabledType <Enum>] [-Instance <PSObject>] [-AllowTranscriptionForCalling <Boolean>] [-Description <String>] [-LiveCaptionsEnabledTypeForCalling <String>] [-SpamFilteringEnabledType <String>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
28+
Set-CsTeamsCallingPolicy [-Tenant <System.Guid>] [-AllowCalling <Boolean>] [-AllowPrivateCalling <Boolean>] [-AllowVoicemail <String>] [-AllowCallGroups <Boolean>] [-AllowDelegation <Boolean>] [-AllowCallForwardingToUser <Boolean>] [-AllowCallForwardingToPhone <Boolean>] [-AllowCloudRecordingForCalls <Boolean>] [-PreventTollBypass <Boolean>] [-AllowSIPDevicesCalling <Boolean>] [-BusyOnBusyEnabledType <String>] [-MusicOnHoldEnabledType <Enum>] [-AutoAnswerEnabledType <Enum>] [-Instance <PSObject>] [-AllowTranscriptionForCalling <Boolean>] [-Description <String>] [-LiveCaptionsEnabledTypeForCalling <String>] [-SpamFilteringEnabledType <String>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
2929
```
3030

3131
## DESCRIPTION
@@ -297,6 +297,21 @@ Accept pipeline input: False
297297
Accept wildcard characters: False
298298
```
299299
300+
### -AllowSIPDevicesCalling
301+
Determines whether the user is allowed to use SIP device for calling on behalf of teams client.
302+
303+
```yaml
304+
Type: Boolean
305+
Parameter Sets: (All)
306+
Aliases:
307+
308+
Required: False
309+
Position: Named
310+
Default value: None
311+
Accept pipeline input: False
312+
Accept wildcard characters: False
313+
```
314+
300315
### -BusyOnBusyEnabledType
301316
Setting this parameter lets you configure how incoming calls are handled when a user is already in a call or conference or has a call placed on hold. Valid options are: Enabled, Unanswered, Disabled. When set to Enabled, new or incoming calls will be rejected with a busy signal. When set to Unanswered, the user's unanswered settings will take effect, such as routing to voicemail or forwarding to another user. Note: UserOverride option value is not available for use currently, if set it will be read as setting value to Disabled.
302317
Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
---
2+
external help file: Microsoft.Open.Teams.CommonLibrary.dll-Help.xml
3+
Module Name: MicrosoftTeams
4+
online version: https://docs.microsoft.com/powershell/module/teams/remove-csphonenumberassignment
5+
applicable: Microsoft Teams
6+
author: jenstrier
7+
ms.author: jenstr
8+
ms.reviewer:
9+
manager:
10+
schema: 2.0.0
11+
---
12+
13+
# Remove-CsPhoneNumberAssignment
14+
15+
## SYNOPSIS
16+
This cmdlet will remove/unassign a phone number from a user or a resource account (online application instance).
17+
18+
> [!NOTE]
19+
> **Preview** The use of this cmdlet is in Public Preview.
20+
21+
## SYNTAX
22+
23+
```powershell
24+
Remove-CsPhoneNumberAssignment [[-Identity] <String> [-PhoneNumber <String>] [-PhoneNumberType <String>] [-RemoveAll] [<CommonParameters>]
25+
26+
```
27+
28+
## DESCRIPTION
29+
This cmdlet removes/unassigns a phone number from a user or resource account. The phone number continues to be available in the tenant.
30+
31+
Unassigning a phone number from a user or resource account will automatically set EnterpriseVoiceEnabled to False.
32+
33+
## EXAMPLES
34+
35+
### Example 1
36+
```powershell
37+
Remove-CsPhoneNumberAssignment -Identity [email protected] -PhoneNumber +12065551234 -PhoneNumberType CallingPlan
38+
```
39+
This example removes/unassigns the Microsoft Calling Plan phone number +1 (206) 555-1234 from the user [email protected].
40+
41+
### Example 2
42+
```powershell
43+
Remove-CsPhoneNumberAssignment -Identity [email protected] -RemoveAll
44+
```
45+
This example removes/unassigns the phone number from [email protected].
46+
47+
48+
## PARAMETERS
49+
50+
### -Identity
51+
The Id of the specific user or resource account. Can be specified using the ObjectId, the SIP address or the e-mail address.
52+
53+
```yaml
54+
Type: System.String
55+
Parameter Sets: (All)
56+
Aliases:
57+
58+
Required: True
59+
Default value: None
60+
Accept pipeline input: False
61+
Accept wildcard characters: False
62+
```
63+
64+
### -PhoneNumber
65+
The phone number to unnassign from the user or resource account. Supports E.164 format and non-E.164 format.
66+
67+
```yaml
68+
Type: System.String
69+
Parameter Sets: (All)
70+
Aliases:
71+
72+
Required: False
73+
Default value: None
74+
Accept pipeline input: False
75+
Accept wildcard characters: False
76+
```
77+
78+
### -PhoneNumberType
79+
The type of phone number to unassign from the user or resource account. The supported values are DirectRouting, CallingPlan and OperatorConnect.
80+
81+
```yaml
82+
Type: System.String
83+
Parameter Sets: (All)
84+
Aliases:
85+
86+
Required: False
87+
Default value: None
88+
Accept pipeline input: False
89+
Accept wildcard characters: False
90+
```
91+
92+
### -RemoveAll
93+
Unassigns the phone number from the user or resource account.
94+
95+
```yaml
96+
Type: Switch
97+
Parameter Sets: (All)
98+
Aliases:
99+
100+
Required: False
101+
Default value: None
102+
Accept pipeline input: False
103+
Accept wildcard characters: False
104+
```
105+
106+
### CommonParameters
107+
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).
108+
109+
## INPUTS
110+
111+
### None
112+
113+
## OUTPUTS
114+
115+
### System.Object
116+
117+
## NOTES
118+
The cmdlet is available in Teams PS module 2.6.1-preview or later.
119+
120+
## RELATED LINKS
121+
- [Set-CsPhoneNumberAssignment](Set-CsPhoneNumberAssignment.md)

0 commit comments

Comments
 (0)