Skip to content

Commit b8d9e73

Browse files
authored
Merge pull request MicrosoftDocs#9717 from JensTrier/JensBlockedNumbers
Various updates to blocked numbers cmdlet
2 parents 6e88363 + 556a631 commit b8d9e73

8 files changed

+151
-422
lines changed

skype/skype-ps/skype/Get-CsInboundBlockedNumberPattern.md

Lines changed: 17 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
22
external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml
33
online version: https://docs.microsoft.com/powershell/module/skype/get-csinboundblockednumberpattern
4-
applicable: Skype for Business Online
4+
applicable: Microsoft Teams, Skype for Business Online
55
title: Get-CsInboundBlockedNumberPattern
6-
author: tomkau
7-
ms.author: tomkau
6+
author: jenstrier
7+
ms.author: jenstr
88
ms.reviewer:
99
manager: bulenteg
1010
schema: 2.0.0
@@ -19,14 +19,12 @@ Returns a list of all blocked number patterns added to the tenant list.
1919

2020
### Identity (Default)
2121
```
22-
Get-CsInboundBlockedNumberPattern [-Tenant <Guid>] [[-Identity] <XdsGlobalRelativeIdentity>]
23-
[-LocalStore] [<CommonParameters>]
22+
Get-CsInboundBlockedNumberPattern [[-Identity] <string>] [<CommonParameters>]
2423
```
2524

2625
### Filter
2726
```
28-
Get-CsInboundBlockedNumberPattern [-Tenant <Guid>] [-Filter <String>] [-LocalStore]
29-
[<CommonParameters>]
27+
Get-CsInboundBlockedNumberPattern [-Filter <string>] [<CommonParameters>]
3028
```
3129

3230
## DESCRIPTION
@@ -36,15 +34,23 @@ This cmdlet returns a list of all blocked number patterns added to the tenant li
3634

3735
### Example 1
3836
```powershell
39-
PS C:> Get-CsInboundBlockedNumberPattern
37+
PS> Get-CsInboundBlockedNumberPattern
4038
```
4139

42-
In the preceding example, the *Get-CsInboundBlockedNumberPattern* cmdlet is called without any parameters in order to return all the blocked number patterns.
40+
In this example, the *Get-CsInboundBlockedNumberPattern* cmdlet is called without any parameters in order to return all the blocked number patterns.
41+
42+
### Example 2
43+
```powershell
44+
PS> Get-CsInboundBlockedNumberPattern -Filter Block*
45+
```
46+
47+
In this example, the *Get-CsInboundBlockedNumberPattern* cmdlet will return all the blocked number patterns which identity starts with Block.
48+
4349

4450
## PARAMETERS
4551

4652
### -Filter
47-
Enables you to limit the returned data by filtering on Skype for Business Online-specific attributes. The Filter parameter uses the same Windows PowerShell filtering syntax that is used by the Where-Object cmdlet.
53+
Enables you to limit the returned data by filtering on the Identity.
4854

4955
```yaml
5056
Type: String
@@ -62,7 +68,7 @@ Accept wildcard characters: False
6268
Indicates the Identity of the blocked number patterns to return.
6369
6470
```yaml
65-
Type: XdsGlobalRelativeIdentity
71+
Type: String
6672
Parameter Sets: Identity
6773
Aliases:
6874

@@ -73,46 +79,13 @@ Accept pipeline input: False
7379
Accept wildcard characters: False
7480
```
7581
76-
### -LocalStore
77-
This parameter is reserved for internal Microsoft use.
78-
79-
```yaml
80-
Type: SwitchParameter
81-
Parameter Sets: (All)
82-
Aliases:
83-
84-
Required: False
85-
Position: Named
86-
Default value: None
87-
Accept pipeline input: False
88-
Accept wildcard characters: False
89-
```
90-
91-
### -Tenant
92-
This parameter is reserved for internal Microsoft use.
93-
94-
```yaml
95-
Type: Guid
96-
Parameter Sets: (All)
97-
Aliases:
98-
99-
Required: False
100-
Position: Named
101-
Default value: None
102-
Accept pipeline input: False
103-
Accept wildcard characters: False
104-
```
105-
10682
### CommonParameters
10783
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).
10884
10985
## INPUTS
11086
111-
### None
112-
11387
## OUTPUTS
11488
115-
### System.Object
11689
## NOTES
11790
11891
## RELATED LINKS
Lines changed: 23 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml
33
online version: https://docs.microsoft.com/powershell/module/skype/get-csinboundexemptnumberpattern
4-
applicable: Skype for Business Online and Teams
4+
applicable: Microsoft Teams, Skype for Business Online
55
author: jenstrier
66
ms.author: jenstr
77
ms.reviewer:
@@ -16,8 +16,14 @@ Returns a specific or the full list of all number patterns exempt from call bloc
1616

1717
## SYNTAX
1818

19+
### Identity (Default)
1920
```
20-
Get-CsInboundExemptNumberPattern [[-Identity] <XdsGlobalRelativeIdentity>] [-Tenant <Guid>] [-Filter <Object>] [-LocalStore] [<CommonParameters>]
21+
Get-CsInboundBlockedNumberPattern [[-Identity] <string>] [<CommonParameters>]
22+
```
23+
24+
### Filter
25+
```
26+
Get-CsInboundBlockedNumberPattern [-Filter <string>] [<CommonParameters>]
2127
```
2228

2329
## DESCRIPTION
@@ -27,25 +33,32 @@ This cmdlet returns a specific or all exempt number patterns added to the tenant
2733

2834
### Example 1
2935
```powershell
30-
Get-CsInboundExemptNumberPattern
36+
PS>Get-CsInboundExemptNumberPattern
3137
```
3238
This returns all exempt number patterns.
3339

3440
### Example 2
3541
```powershell
36-
Get-CsInboundExemptNumberPattern -Identity "Exempt1"
42+
PS>Get-CsInboundExemptNumberPattern -Identity "Exempt1"
3743
```
3844

3945
This returns the exempt number patterns with Identity Exempt1.
4046

47+
### Example 3
48+
```powershell
49+
PS>Get-CsInboundExemptNumberPattern -Filter "Exempt*"
50+
```
51+
52+
This example returns the exempt number patterns with Identity starting with Exempt.
53+
4154
## PARAMETERS
4255

4356
### -Filter
44-
Enables you to limit the returned data by filtering on specific attributes. The Filter parameter uses the same Windows PowerShell filtering syntax that is used by the Where-Object cmdlet.
57+
Enables you to limit the returned data by filtering on Identity.
4558

4659
```yaml
47-
Type: Object
48-
Parameter Sets: (All)
60+
Type: String
61+
Parameter Sets: (Filter)
4962
Aliases:
5063

5164
Required: False
@@ -59,55 +72,21 @@ Accept wildcard characters: False
5972
Unique identifier for the exempt number pattern to be listed.
6073
6174
```yaml
62-
Type: XdsGlobalRelativeIdentity
63-
Parameter Sets: (All)
64-
Aliases:
65-
66-
Required: True
67-
Position: 1
68-
Default value: None
69-
Accept pipeline input: False
70-
Accept wildcard characters: False
71-
```
72-
73-
### -LocalStore
74-
This parameter is reserved for internal Microsoft use.
75-
76-
```yaml
77-
Type: SwitchParameter
78-
Parameter Sets: (All)
75+
Type: String
76+
Parameter Sets: (Identity)
7977
Aliases:
8078

8179
Required: False
82-
Position: Named
83-
Default value: None
84-
Accept pipeline input: False
85-
Accept wildcard characters: False
86-
```
87-
88-
### -Tenant
89-
This parameter is reserved for internal Microsoft use.
90-
91-
```yaml
92-
Type: System.Guid
93-
Parameter Sets: (All)
94-
Aliases:
95-
96-
Required: False
97-
Position: Named
80+
Position: 1
9881
Default value: None
9982
Accept pipeline input: False
10083
Accept wildcard characters: False
10184
```
10285
10386
## INPUTS
10487
105-
### None
106-
10788
## OUTPUTS
10889
109-
### System.Object
110-
11190
## NOTES
11291
11392
You can use Test-CsInboundBlockedNumberPattern to test your call block and exempt phone number ranges.
@@ -122,4 +101,3 @@ You can use Test-CsInboundBlockedNumberPattern to test your call block and exemp
122101
[Test-CsInboundBlockedNumberPattern](Test-CsInboundBlockedNumberPattern.md)
123102
124103
[Get-CsTenantBlockedCallingNumbers](Get-CsTenantBlockedCallingNumbers.md)
125-

skype/skype-ps/skype/New-CsInboundBlockedNumberPattern.md

Lines changed: 18 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
22
external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml
33
online version: https://docs.microsoft.com/powershell/module/skype/new-csinboundblockednumberpattern
4-
applicable: Skype for Business Online
4+
applicable: Microsoft Teams, Skype for Business Online
55
title: New-CsInboundBlockedNumberPattern
6-
author: tomkau
7-
ms.author: tomkau
6+
author: jenstrier
7+
ms.author: jenstr
88
ms.reviewer:
99
manager: bulenteg
1010
schema: 2.0.0
@@ -19,47 +19,30 @@ Adds a blocked number pattern to the tenant list.
1919

2020
### Identity (Default)
2121
```
22-
New-CsInboundBlockedNumberPattern [-Tenant <Guid>] [-Enabled <Boolean>] [-Description <String>]
23-
-Pattern <String> [-Identity] <XdsGlobalRelativeIdentity> [-InMemory] [-Force] [-WhatIf] [-Confirm]
24-
[<CommonParameters>]
22+
New-CsInboundBlockedNumberPattern [-Identity] <string> -Pattern <string> [-Description <string>] [-Enabled <boolean>]
23+
[-WhatIf] [-Confirm] [<CommonParameters>]
2524
```
2625

2726
### ParentAndRelativeKey
2827
```
29-
New-CsInboundBlockedNumberPattern [-Tenant <Guid>] -Name <String> [-Enabled <Boolean>]
30-
[-Description <String>] -Pattern <String> [-InMemory] [-Force] [-WhatIf] [-Confirm]
31-
[<CommonParameters>]
28+
New-CsInboundBlockedNumberPattern -Pattern <string> -Name <string> [-Description <string>] [-Enabled <boolean>]
29+
[-WhatIf] [-Confirm] [<CommonParameters>]
3230
```
3331

3432
## DESCRIPTION
35-
This cmdlet adds a blocked number pattern to the tenant list.
33+
This cmdlet adds a blocked number pattern to the tenant list. An inbound PSTN call from a number that matches the blocked number pattern will be blocked.
3634

3735
## EXAMPLES
3836

3937
### Example 1
4038
```powershell
41-
PS C:> New-CsInboundBlockedNumberPattern -Description "Avoid Unwanted Automatic Call" -Name "BlockAutomatic" -Pattern "^\+11234567890"
39+
PS> New-CsInboundBlockedNumberPattern -Description "Avoid Unwanted Automatic Call" -Name "BlockAutomatic" -Pattern "^\+11234567890"
4240
```
4341

4442
This example adds a blocked number pattern to block inbound calls from +11234567890 number.
4543

4644
## PARAMETERS
4745

48-
### -Confirm
49-
Prompts you for confirmation before running the cmdlet.
50-
51-
```yaml
52-
Type: SwitchParameter
53-
Parameter Sets: (All)
54-
Aliases: cf
55-
56-
Required: False
57-
Position: Named
58-
Default value: None
59-
Accept pipeline input: False
60-
Accept wildcard characters: False
61-
```
62-
6346
### -Description
6447
A friendly description for the blocked number pattern to be created.
6548

@@ -90,26 +73,11 @@ Accept pipeline input: False
9073
Accept wildcard characters: False
9174
```
9275
93-
### -Force
94-
The *Force* switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the *Force* switch isn't provided in the command, you're prompted for administrative input if required.
95-
96-
```yaml
97-
Type: SwitchParameter
98-
Parameter Sets: (All)
99-
Aliases:
100-
101-
Required: False
102-
Position: Named
103-
Default value: None
104-
Accept pipeline input: False
105-
Accept wildcard characters: False
106-
```
107-
10876
### -Identity
10977
A unique identifier specifying the blocked number pattern to be created.
11078
11179
```yaml
112-
Type: XdsGlobalRelativeIdentity
80+
Type: String
11381
Parameter Sets: Identity
11482
Aliases:
11583

@@ -120,21 +88,6 @@ Accept pipeline input: False
12088
Accept wildcard characters: False
12189
```
12290
123-
### -InMemory
124-
Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet's matching Set-.
125-
126-
```yaml
127-
Type: SwitchParameter
128-
Parameter Sets: (All)
129-
Aliases:
130-
131-
Required: False
132-
Position: Named
133-
Default value: None
134-
Accept pipeline input: False
135-
Accept wildcard characters: False
136-
```
137-
13891
### -Name
13992
A displayable name describing the blocked number pattern to be created.
14093
@@ -165,13 +118,14 @@ Accept pipeline input: False
165118
Accept wildcard characters: False
166119
```
167120
168-
### -Tenant
169-
This parameter is reserved for internal Microsoft use.
121+
### -WhatIf
122+
Shows what would happen if the cmdlet runs.
123+
The cmdlet is not run.
170124
171125
```yaml
172-
Type: System.Guid
126+
Type: SwitchParameter
173127
Parameter Sets: (All)
174-
Aliases:
128+
Aliases: wi
175129

176130
Required: False
177131
Position: Named
@@ -180,14 +134,13 @@ Accept pipeline input: False
180134
Accept wildcard characters: False
181135
```
182136
183-
### -WhatIf
184-
Shows what would happen if the cmdlet runs.
185-
The cmdlet is not run.
137+
### -Confirm
138+
Prompts you for confirmation before running the cmdlet.
186139
187140
```yaml
188141
Type: SwitchParameter
189142
Parameter Sets: (All)
190-
Aliases: wi
143+
Aliases: cf
191144

192145
Required: False
193146
Position: Named

0 commit comments

Comments
 (0)