Skip to content

Commit b756003

Browse files
Merge pull request #13182 from 7sedam7/main
Added ResourceAccount parameter to the docs
2 parents 38338e7 + 120ed01 commit b756003

File tree

3 files changed

+60
-4
lines changed

3 files changed

+60
-4
lines changed

teams/teams-ps/MicrosoftTeams/New-CsInboundBlockedNumberPattern.md

Lines changed: 25 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,18 +20,18 @@ Adds a blocked number pattern to the tenant list.
2020

2121
### Identity (Default)
2222
```
23-
New-CsInboundBlockedNumberPattern [-Identity] <string> -Pattern <string> [-Description <string>] [-Enabled <boolean>]
23+
New-CsInboundBlockedNumberPattern [-Identity] <string> -Pattern <string> [-ResourceAccount <guid>] [-Description <string>] [-Enabled <boolean>]
2424
[-WhatIf] [-Confirm] [<CommonParameters>]
2525
```
2626

2727
### ParentAndRelativeKey
2828
```
29-
New-CsInboundBlockedNumberPattern -Pattern <string> -Name <string> [-Description <string>] [-Enabled <boolean>]
29+
New-CsInboundBlockedNumberPattern -Pattern <string> -Name <string> [-ResourceAccount <guid>] [-Description <string>] [-Enabled <boolean>]
3030
[-WhatIf] [-Confirm] [<CommonParameters>]
3131
```
3232

3333
## DESCRIPTION
34-
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.
34+
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. If a ResourceAccount is specified, the call will be redirected to that resource account instead of being blocked.
3535

3636
## EXAMPLES
3737

@@ -42,6 +42,13 @@ PS> New-CsInboundBlockedNumberPattern -Description "Avoid Unwanted Automatic Cal
4242

4343
This example adds a blocked number pattern to block inbound calls from +11234567890 number.
4444

45+
### Example 2
46+
```powershell
47+
PS> New-CsInboundBlockedNumberPattern -Description "Avoid Unwanted Automatic Call" -Name "BlockAutomatic" -Pattern "^\+11234567890" -ResourceAccount "d290f1ee-6c54-4b01-90e6-d701748f0851"
48+
```
49+
50+
This example adds a blocked number pattern to redirect inbound calls from +11234567890 number to the specified resource account instead of blocking it.
51+
4552
## PARAMETERS
4653

4754
### -Confirm
@@ -134,6 +141,21 @@ Accept pipeline input: False
134141
Accept wildcard characters: False
135142
```
136143
144+
### -ResourceAccount
145+
The GUID of a resource account to redirect calls to when the pattern matches. If specified, matched calls will be redirected to this resource account instead of being blocked.
146+
147+
```yaml
148+
Type: Guid
149+
Parameter Sets: (All)
150+
Aliases:
151+
152+
Required: False
153+
Position: Named
154+
Default value: None
155+
Accept pipeline input: False
156+
Accept wildcard characters: False
157+
```
158+
137159
### -WhatIf
138160
Shows what would happen if the cmdlet runs.
139161
The cmdlet is not run.

teams/teams-ps/MicrosoftTeams/Set-CsInboundBlockedNumberPattern.md

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Modifies one or more parameters of a blocked number pattern in the tenant list.
2020

2121
### Identity (Default)
2222
```
23-
Set-CsInboundBlockedNumberPattern [[-Identity] <string>] [-Description <string>] [-Enabled <boolean>] [-Pattern <string>]
23+
Set-CsInboundBlockedNumberPattern [[-Identity] <string>] [-Description <string>] [-Enabled <boolean>] [-Pattern <string>] [-ResourceAccount <guid>]
2424
[-WhatIf] [-Confirm] [<CommonParameters>]
2525
```
2626

@@ -36,6 +36,13 @@ PS> Set-CsInboundBlockedNumberPattern -Identity "BlockAutomatic" -Pattern "^\+11
3636

3737
This example modifies a blocked number pattern to block inbound calls from +11234567890 number.
3838

39+
### Example 2
40+
```powershell
41+
PS> Set-CsInboundBlockedNumberPattern -Identity "BlockAutomatic" -ResourceAccount "d290f1ee-6c54-4b01-90e6-d701748f0851"
42+
```
43+
44+
This example modifies a blocked number pattern to redirect inbound calls from its pattern number to the specified resource account instead of blocking it.
45+
3946
## PARAMETERS
4047

4148
### -Confirm
@@ -113,6 +120,21 @@ Accept pipeline input: False
113120
Accept wildcard characters: False
114121
```
115122
123+
### -ResourceAccount
124+
The GUID of a resource account to redirect calls to when the pattern matches. If specified, matched calls will be redirected to this resource account instead of being blocked.
125+
126+
```yaml
127+
Type: Guid
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+
116138
### -WhatIf
117139
Shows what would happen if the cmdlet runs.
118140
The cmdlet is not run.

teams/teams-ps/MicrosoftTeams/Test-CsInboundBlockedNumberPattern.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,9 @@ title: Test-CsInboundBlockedNumberPattern
1414

1515
## SYNOPSIS
1616
This cmdlet tests the given number against the created (by using New-CsInboundBlockedNumberPattern cmdlet) blocked numbers pattern.
17+
Cmdlet will return an object with two properties:
18+
- IsMatch: True if the given number matches any of the blocked number patterns, otherwise False
19+
- ResourceAccount: If the matched blocked number pattern has a ResourceAccount assigned, it will return the ResourceAccount Guid, otherwise null.
1720

1821
## SYNTAX
1922

@@ -109,6 +112,15 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
109112
## OUTPUTS
110113
111114
### System.Object
115+
An object with two properties:
116+
- IsMatch: True if the given number matches any of the blocked number patterns, otherwise False
117+
- ResourceAccount: If the matched blocked number pattern has a ResourceAccount assigned, it will return the ResourceAccount Guid, otherwise null.
118+
```
119+
{
120+
"IsMatch": true,
121+
"ResourceAccount": "00000000-0000-0000-0000-000000000000"
122+
}
123+
```
112124

113125
## NOTES
114126

0 commit comments

Comments
 (0)