Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 25 additions & 3 deletions teams/teams-ps/MicrosoftTeams/New-CsInboundBlockedNumberPattern.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,18 +20,18 @@ Adds a blocked number pattern to the tenant list.

### Identity (Default)
```
New-CsInboundBlockedNumberPattern [-Identity] <string> -Pattern <string> [-Description <string>] [-Enabled <boolean>]
New-CsInboundBlockedNumberPattern [-Identity] <string> -Pattern <string> [-ResourceAccount <guid>] [-Description <string>] [-Enabled <boolean>]
[-WhatIf] [-Confirm] [<CommonParameters>]
```

### ParentAndRelativeKey
```
New-CsInboundBlockedNumberPattern -Pattern <string> -Name <string> [-Description <string>] [-Enabled <boolean>]
New-CsInboundBlockedNumberPattern -Pattern <string> -Name <string> [-ResourceAccount <guid>] [-Description <string>] [-Enabled <boolean>]
[-WhatIf] [-Confirm] [<CommonParameters>]
```

## DESCRIPTION
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.
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.

## EXAMPLES

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

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

### Example 2
```powershell
PS> New-CsInboundBlockedNumberPattern -Description "Avoid Unwanted Automatic Call" -Name "BlockAutomatic" -Pattern "^\+11234567890" -ResourceAccount "d290f1ee-6c54-4b01-90e6-d701748f0851"
```

This example adds a blocked number pattern to redirect inbound calls from +11234567890 number to the specified resource account instead of blocking it.

## PARAMETERS

### -Confirm
Expand Down Expand Up @@ -134,6 +141,21 @@ Accept pipeline input: False
Accept wildcard characters: False
```

### -ResourceAccount
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.

```yaml
Type: Guid
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -WhatIf
Shows what would happen if the cmdlet runs.
The cmdlet is not run.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Modifies one or more parameters of a blocked number pattern in the tenant list.

### Identity (Default)
```
Set-CsInboundBlockedNumberPattern [[-Identity] <string>] [-Description <string>] [-Enabled <boolean>] [-Pattern <string>]
Set-CsInboundBlockedNumberPattern [[-Identity] <string>] [-Description <string>] [-Enabled <boolean>] [-Pattern <string>] [-ResourceAccount <guid>]
[-WhatIf] [-Confirm] [<CommonParameters>]
```

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

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

### Example 2
```powershell
PS> Set-CsInboundBlockedNumberPattern -Identity "BlockAutomatic" -ResourceAccount "d290f1ee-6c54-4b01-90e6-d701748f0851"
```

This example modifies a blocked number pattern to redirect inbound calls from its pattern number to the specified resource account instead of blocking it.

## PARAMETERS

### -Confirm
Expand Down Expand Up @@ -113,6 +120,21 @@ Accept pipeline input: False
Accept wildcard characters: False
```

### -ResourceAccount
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.

```yaml
Type: Guid
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -WhatIf
Shows what would happen if the cmdlet runs.
The cmdlet is not run.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,9 @@ title: Test-CsInboundBlockedNumberPattern

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

## SYNTAX

Expand Down Expand Up @@ -109,6 +112,15 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
## OUTPUTS

### System.Object
An object with two properties:
- IsMatch: True if the given number matches any of the blocked number patterns, otherwise False
- ResourceAccount: If the matched blocked number pattern has a ResourceAccount assigned, it will return the ResourceAccount Guid, otherwise null.
```
{
"IsMatch": true,
"ResourceAccount": "00000000-0000-0000-0000-000000000000"
}
```

## NOTES

Expand Down