Skip to content

Commit beb4e20

Browse files
Merge branch 'main' into patch-4
2 parents 2ff2b5f + ebac84c commit beb4e20

File tree

7 files changed

+261
-4
lines changed

7 files changed

+261
-4
lines changed

exchange/exchange-ps/ExchangePowerShell/ExchangePowerShell.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -345,6 +345,8 @@ Exchange PowerShell is built on PowerShell technology to a powerful command-line
345345

346346
### [Remove-ContentFilterPhrase](Remove-ContentFilterPhrase.md)
347347

348+
### [Remove-DkimSigningConfig](Remove-DkimSigningConfig.md)
349+
348350
### [Remove-EOPProtectionPolicyRule](Remove-EOPProtectionPolicyRule.md)
349351

350352
### [Remove-ExoPhishSimOverrideRule](Remove-ExoPhishSimOverrideRule.md)
Lines changed: 136 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,136 @@
1+
---
2+
applicable: Exchange Online, Exchange Online Protection
3+
author: chrisda
4+
external help file: Microsoft.Exchange.TransportMailflow-Help.xml
5+
Locale: en-US
6+
Module Name: ExchangePowerShell
7+
ms.author: chrisda
8+
online version: https://learn.microsoft.com/powershell/module/exchangepowershell/remove-dkimsigningconfig
9+
schema: 2.0.0
10+
title: Remove-DkimSigningConfig
11+
---
12+
13+
# Remove-DkimSigningConfig
14+
15+
## SYNOPSIS
16+
This cmdlet is available only in the cloud-based service.
17+
18+
Use the Remove-DkimSigningConfig cmdlet to remove the DomainKeys Identified Mail (DKIM) signing policy settings for domains in a cloud-based organization.
19+
20+
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
21+
22+
## SYNTAX
23+
24+
```
25+
Remove-DkimSigningConfig [-Identity] <DkimSigningConfigIdParameter>
26+
[-Confirm]
27+
[-Force]
28+
[-WhatIf]
29+
[<CommonParameters>]
30+
```
31+
32+
## DESCRIPTION
33+
You need to be assigned permissions before you can run this cmdlet. Although this article lists all parameters for the cmdlet, you might not have access to some parameters if they aren't included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://learn.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
34+
35+
## EXAMPLES
36+
37+
### Example 1
38+
```powershell
39+
Remove-DkimSigningConfig -Identity contoso.com
40+
```
41+
42+
This example removes the DKIM signing policy for the contoso.com domain.
43+
44+
## PARAMETERS
45+
46+
### -Identity
47+
48+
> Applicable: Exchange Online, Exchange Online Protection
49+
50+
The Identity parameter specifies the DKIM signing policy that you want to remove. You can use any value that uniquely identifies the policy. For example:
51+
52+
- Name: The domain name (for example, contoso.com).
53+
- Distinguished name (DN)
54+
- GUID
55+
56+
```yaml
57+
Type: DkimSigningConfigIdParameter
58+
Parameter Sets: (All)
59+
Aliases:
60+
61+
Required: True
62+
Position: 0
63+
Default value: None
64+
Accept pipeline input: True (ByPropertyName, ByValue)
65+
Accept wildcard characters: False
66+
```
67+
68+
### -Confirm
69+
70+
> Applicable: Exchange Online, Exchange Online Protection
71+
72+
The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on if the cmdlet requires confirmation before proceeding.
73+
74+
- Destructive cmdlets (for example, Remove-\* cmdlets) have a built-in pause that forces you to acknowledge the command before proceeding. For these cmdlets, you can skip the confirmation prompt by using this exact syntax: `-Confirm:$false`.
75+
- Most other cmdlets (for example, New-\* and Set-\* cmdlets) don't have a built-in pause. For these cmdlets, specifying the Confirm switch without a value introduces a pause that forces you acknowledge the command before proceeding.
76+
77+
```yaml
78+
Type: SwitchParameter
79+
Parameter Sets: (All)
80+
Aliases: cf
81+
82+
Required: False
83+
Position: Named
84+
Default value: None
85+
Accept pipeline input: False
86+
Accept wildcard characters: False
87+
```
88+
89+
### -Force
90+
91+
> Applicable: Exchange Online, Exchange Online Protection
92+
93+
The Force switch hides warning or confirmation messages. You don't need to specify a value with this switch.
94+
95+
You can use this switch to run tasks programmatically where prompting for administrative input is inappropriate.
96+
97+
```yaml
98+
Type: SwitchParameter
99+
Parameter Sets: (All)
100+
Aliases:
101+
102+
Required: False
103+
Position: Named
104+
Default value: None
105+
Accept pipeline input: False
106+
Accept wildcard characters: False
107+
```
108+
109+
### -WhatIf
110+
111+
> Applicable: Exchange Online, Exchange Online Protection
112+
113+
The WhatIf switch simulates the actions of the command. You can use this switch to view the changes that would occur without actually applying those changes. You don't need to specify a value with this switch.
114+
115+
```yaml
116+
Type: SwitchParameter
117+
Parameter Sets: (All)
118+
Aliases: wi
119+
120+
Required: False
121+
Position: Named
122+
Default value: None
123+
Accept pipeline input: False
124+
Accept wildcard characters: False
125+
```
126+
127+
### CommonParameters
128+
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/p/?LinkID=113216).
129+
130+
## INPUTS
131+
132+
## OUTPUTS
133+
134+
## NOTES
135+
136+
## RELATED LINKS

exchange/mapping/serviceMapping.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -159,6 +159,7 @@
159159
"Remove-BlockedConnector": "antispam-antimalware",
160160
"Remove-BlockedSenderAddress": "antispam-antimalware",
161161
"Remove-ContentFilterPhrase": "antispam-antimalware",
162+
"Remove-DkimSigningConfig": "antispam-antimalware",
162163
"Remove-EOPProtectionPolicyRule": "antispam-antimalware",
163164
"Remove-ExoPhishSimOverrideRule": "antispam-antimalware",
164165
"Remove-ExoSecOpsOverrideRule": "antispam-antimalware",

teams/teams-ps/MicrosoftTeams/Get-CsPhoneNumberAssignment.md

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -288,6 +288,68 @@ AssignmentBlockedUntil :
288288
```
289289
This example shows a way to get filtered results using tags. Tags are not case sensitive.
290290

291+
### Example 14
292+
```powershell
293+
Get-CsPhoneNumberAssignment -TelephoneNumber +14025551234
294+
```
295+
```output
296+
TelephoneNumber : +14025551234
297+
OperatorId : 2b24d246-a9ee-428b-96bc-fb9d9a053c8d
298+
NumberType : CallingPlan
299+
ActivationState : Activated
300+
AssignedPstnTargetId :
301+
AssignmentCategory :
302+
Capability : {UserAssignment}
303+
City : Omaha
304+
CivicAddressId :
305+
IsoCountryCode : US
306+
IsoSubdivision : Nebraska
307+
LocationId :
308+
LocationUpdateSupported : True
309+
NetworkSiteId :
310+
PortInOrderStatus :
311+
PstnAssignmentStatus : Unassigned
312+
PstnPartnerId : 7fc2f2eb-89aa-41d7-93de-73d015d22ff0
313+
PstnPartnerName : Microsoft
314+
NumberSource : Online
315+
ReverseNumberLookup : {}
316+
Tag : {}
317+
AssignmentBlockedState : BlockedForever
318+
AssignmentBlockedUntil :
319+
```
320+
This example displays information about the telephone number +1 (402) 555-1234 which has a permanent assignment block. This block prevents the number from being assigned to any other user. Admin can remove the block using [Remove-CsPhoneNumberAssignmentBlock](./remove-csphonenumberassignmentblock.md).
321+
322+
### Example 15
323+
```powershell
324+
Get-CsPhoneNumberAssignment -TelephoneNumber +14025551234
325+
```
326+
```output
327+
TelephoneNumber : +14025551234
328+
OperatorId : 2b24d246-a9ee-428b-96bc-fb9d9a053c8d
329+
NumberType : CallingPlan
330+
ActivationState : Activated
331+
AssignedPstnTargetId :
332+
AssignmentCategory :
333+
Capability : {UserAssignment}
334+
City : Omaha
335+
CivicAddressId :
336+
IsoCountryCode : US
337+
IsoSubdivision : Nebraska
338+
LocationId :
339+
LocationUpdateSupported : True
340+
NetworkSiteId :
341+
PortInOrderStatus :
342+
PstnAssignmentStatus : Unassigned
343+
PstnPartnerId : 7fc2f2eb-89aa-41d7-93de-73d015d22ff0
344+
PstnPartnerName : Microsoft
345+
NumberSource : Online
346+
ReverseNumberLookup : {}
347+
Tag : {}
348+
AssignmentBlockedState : BlockedUntil
349+
AssignmentBlockedUntil : 2025-10-11T21:30:00.0000000Z
350+
```
351+
This example displays information about the telephone number +1 (402) 555-1234 which has a temporary assignment block. This block prevents the number from being assigned to any other user. Once the period shown in AssignmentBlockUntil passes, the AssignmentBlock will be automatically removed and the number will become available to be assigned to any user. Admin can also remove the block manually using [Remove-CsPhoneNumberAssignmentBlock](./remove-csphonenumberassignmentblock.md).
352+
291353

292354
## PARAMETERS
293355

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)