You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
27
26
28
27
## EXAMPLES
29
28
30
29
### -------------------------- Example 1 --------------------------
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.
36
54
37
55
38
56
## PARAMETERS
39
57
40
58
### -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.
43
60
44
61
```yaml
45
62
Type: String[]
46
63
Parameter Sets: (All)
47
64
Aliases:
48
-
Applicable: Skype for Business Online
65
+
Applicable: Skype for Business Online, Microsoft Teams
49
66
50
-
Required: False
67
+
Required: True
51
68
Position: Named
52
69
Default value: None
53
70
Accept pipeline input: False
@@ -61,23 +78,7 @@ The Confirm switch causes the command to pause processing and requires confirmat
61
78
Type: SwitchParameter
62
79
Parameter Sets: (All)
63
80
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
81
82
82
83
Required: False
83
84
Position: Named
@@ -95,23 +96,7 @@ If the Force switch isn't provided in the command, you're prompted for administr
95
96
Type: SwitchParameter
96
97
Parameter Sets: (All)
97
98
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
115
100
116
101
Required: False
117
102
Position: Named
@@ -128,7 +113,7 @@ By using this switch, you can view what changes would occur without having to co
128
113
Type: SwitchParameter
129
114
Parameter Sets: (All)
130
115
Aliases: wi
131
-
Applicable: Skype for Business Online
116
+
Applicable: Skype for Business Online, Microsoft Teams
132
117
133
118
Required: False
134
119
Position: Named
@@ -151,6 +136,7 @@ None
151
136
None
152
137
153
138
## 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.
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
+
300
315
### -BusyOnBusyEnabledType
301
316
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.
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.
0 commit comments