Skip to content

Commit 99e0b1d

Browse files
authored
Merge branch 'main' into patch-839316
2 parents 30c1b8b + 0955783 commit 99e0b1d

31 files changed

+988
-160
lines changed

.openpublishing.build.ps1

Lines changed: 0 additions & 17 deletions
This file was deleted.

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ Contributors who make infrequent or small updates can edit the file directly on
3232
Articles on learn.microsoft.com are formatted using the Markdown language. For help on using Markdown, see [Mastering Markdown](https://guides.github.com/features/mastering-markdown/).
3333

3434
> [!TIP]
35-
> Cmdlet reference articles follow a very strict schema with limited formatting options, because the articles are also converted and used for help at the command line (`Get-Help <CmdletName`). Use existing content as a guide. For more information, see [platyPS Schema](https://github.com/PowerShell/platyPS/blob/master/platyPS.schema.md).
35+
> Cmdlet reference articles follow a very strict schema with limited formatting options, because the articles are also converted and used for help at the command line (`Get-Help <CmdletName`). Use existing content as a guide. For more information, see [platyPS Schema](https://github.com/PowerShell/platyPS/blob/master/docs/developer/platyPS/platyPS.schema.md).
3636
3737
Select **Preview** to view your changes as you go. Select **Edit** to go back to making updates.
3838

exchange/exchange-ps/exchange/Disable-DnssecForVerifiedDomain.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,6 @@ ms.reviewer:
1414
## SYNOPSIS
1515
This cmdlet is available only in the cloud-based service.
1616

17-
**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.
18-
1917
Use the Disable-DnssecForVerifiedDomain cmdlet to disable Domain Name System Security (DNSSEC) for inbound mail to accepted domains in Exchange Online.
2018

2119
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

exchange/exchange-ps/exchange/Disable-SmtpDaneInbound.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,6 @@ ms.reviewer:
1414
## SYNOPSIS
1515
This cmdlet is available only in the cloud-based service.
1616

17-
**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.
18-
1917
Use the Disable-SMTPDaneInbound cmdlet to disable SMTP DNS-based Authentication of Named Entities (DANE) for inbound mail to accepted domains in Exchange Online.
2018

2119
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

exchange/exchange-ps/exchange/Enable-DnssecForVerifiedDomain.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,6 @@ ms.reviewer:
1414
## SYNOPSIS
1515
This cmdlet is available only in the cloud-based service.
1616

17-
**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.
18-
1917
Use the Enable-DnssecForVerifiedDomain cmdlet to enable Domain Name System Security (DNSSEC) for inbound mail to accepted domains in Exchange Online.
2018

2119
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

exchange/exchange-ps/exchange/Enable-SmtpDaneInbound.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,6 @@ ms.reviewer:
1414
## SYNOPSIS
1515
This cmdlet is available only in the cloud-based service.
1616

17-
**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.
18-
1917
Use the Enable-SMTPDaneInbound cmdlet to enable SMTP DNS-based Authentication of Named Entities (DANE) for inbound mail to accepted domains in Exchange Online.
2018

2119
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
---
2+
external help file: Microsoft.Exchange.RolesAndAccess-Help.xml
3+
online version: https://learn.microsoft.com/powershell/module/exchange/expedite-delicensing
4+
applicable: Exchange Online
5+
title: Expedite-Delicensing
6+
schema: 2.0.0
7+
author: chrisda
8+
ms.author: chrisda
9+
ms.reviewer:
10+
---
11+
12+
# Expedite-Delicensing
13+
14+
## SYNOPSIS
15+
This cmdlet is available only in the cloud-based service.
16+
17+
Use the Expedite-Delicensing cmdlet to end the delay for removing mailbox licenses from users. After you remove the delay, the licenses are removed from mailboxes within 24 hours. You configure delayed mailbox license removal using the DelayedDelicensingEnabled parameter on the Set-OrganizationConfig cmdlet.
18+
19+
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
20+
21+
## SYNTAX
22+
23+
```
24+
Expedite-Delicensing [-Identity] <RecipientIdParameter>
25+
[<CommonParameters>]
26+
```
27+
28+
## DESCRIPTION
29+
You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not 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).
30+
31+
## EXAMPLES
32+
33+
### Example 1
34+
```powershell
35+
Expedite-Delicensing -Identity yajvendra@contoso.onmicrosoft.com
36+
```
37+
38+
This example ends the delay for the mailbox license removal request on the specified mailbox. Typically, the mailbox license is removed from the mailbox within 30 minutes after running the command, but it might take up to 24 hours.
39+
40+
## PARAMETERS
41+
42+
### -Identity
43+
The Identity parameter specifies the mailbox with a pending mailbox license removal request.
44+
45+
You can use any value that uniquely identifies the mailbox. For example:
46+
47+
- Name
48+
- Alias
49+
- Distinguished name (DN)
50+
- Email address
51+
- GUID
52+
- LegacyExchangeDN
53+
- User ID or user principal name (UPN)
54+
55+
```yaml
56+
Type: RecipientIdParameter
57+
Parameter Sets: (All)
58+
Aliases:
59+
Applicable: Exchange Online
60+
61+
Required: True
62+
Position: 1
63+
Default value: None
64+
Accept pipeline input: False
65+
Accept wildcard characters: False
66+
```
67+
68+
### CommonParameters
69+
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).
70+
71+
## INPUTS
72+
73+
## OUTPUTS
74+
75+
## NOTES
76+
77+
## RELATED LINKS

exchange/exchange-ps/exchange/Get-DnssecStatusForVerifiedDomain.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,6 @@ ms.reviewer:
1414
## SYNOPSIS
1515
This cmdlet is available only in the cloud-based service.
1616

17-
**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.
18-
1917
Use the Get-DnssecStatusForVerifiedDomain cmdlet to view information about Domain Name System Security (DNSSEC) for accepted domains in Exchange Online.
2018

2119
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

exchange/exchange-ps/exchange/Get-EXOMailboxStatistics.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ This example retrieves the minimum set of properties and the specified propertie
6161
## PARAMETERS
6262

6363
### -Archive
64-
The Archive switch parameter specifies whether to return mailbox statistics for the archive mailbox associated with the specified mailbox. You don't need to specify a value with this switch.
64+
The Archive switch specifies whether to return mailbox statistics for the archive mailbox associated with the specified mailbox. You don't need to specify a value with this switch.
6565

6666
```yaml
6767
Type: SwitchParameter

exchange/exchange-ps/exchange/Get-IPv6StatusForAcceptedDomain.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,16 @@ If IPv6 is enabled for an accepted domain in Exchange Online, IPv4 and IPv6 addr
3535
You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not 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).
3636

3737
> [!NOTE]
38-
> When you use the Enable-IPv6ForAcceptedDomain or Disable-IPv6ForAcceptedDomain cmdlets to update the IPv6 setting for an accepted domain, the updated status can take up to an hour to be visible using Get-IPv6StatusForAcceptedDomain due to caching.
3938
>
40-
> For example, Get-IPv6StatusForAcceptedDomain shows the status value Enabled for a domain. You run Disable-IPv6ForAcceptedDomain to disable IPv6 for the domain, you immediately run Get-IPv6StatusForAcceptedDomain to check the staus of the domain, and the command erroneously returns the value Enabled. It might take up to an hour before Get-IPv6StatusForAcceptedDomain shows the correct value Disabled for the domain.
39+
> - When you use the Enable-IPv6ForAcceptedDomain or Disable-IPv6ForAcceptedDomain cmdlets to update the IPv6 setting for an accepted domain, the updated status can take up to an hour to be visible using Get-IPv6StatusForAcceptedDomain due to caching.
40+
>
41+
> For example, Get-IPv6StatusForAcceptedDomain shows the status value Enabled for a domain. You run Disable-IPv6ForAcceptedDomain to disable IPv6 for the domain, you immediately run Get-IPv6StatusForAcceptedDomain to check the status of the domain, and the command erroneously returns the value Enabled. It might take up to an hour before Get-IPv6StatusForAcceptedDomain shows the correct value Disabled for the domain.
42+
>
43+
> - If you receive the following error when running Get-Ipv6StatusForAcceptedDomain:
44+
>
45+
> WARNING: DNS record has unexpected value…..
46+
>
47+
> Explicitly enable or disable IPv6 using the Enable-Ipv6ForAcceptedDomain or Disable-Ipv6ForAcceptedDomain cmdlets.
4148
4249
## EXAMPLES
4350

@@ -101,7 +108,10 @@ Accept wildcard characters: False
101108
### CommonParameters
102109
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).
103110
111+
## INPUTS
104112
113+
## OUTPUTS
105114
115+
## NOTES
106116
107-
117+
## RELATED LINKS
Lines changed: 135 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,135 @@
1+
---
2+
external help file: Microsoft.Exchange.RolesAndAccess-Help.xml
3+
online version: https://learn.microsoft.com/powershell/module/exchange/get-pendingdelicenseuser
4+
applicable: Exchange Online
5+
title: Get-PendingDelicenseUser
6+
schema: 2.0.0
7+
author: chrisda
8+
ms.author: chrisda
9+
ms.reviewer:
10+
---
11+
12+
13+
# Get-PendingDelicenseUser
14+
15+
## SYNOPSIS
16+
This cmdlet is available only in the cloud-based service.
17+
18+
Use the Get-PendingDelicenseUser cmdlet to view information about mailboxes that have delayed mailbox license removal requests. You configure delayed mailbox license removal using the DelayedDelicensingEnabled parameter on the Set-OrganizationConfig cmdlet.
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+
### Identity (Default)
25+
```
26+
Get-PendingDelicenseUser [[-Identity] <RecipientIdParameter>]
27+
[<CommonParameters>]
28+
```
29+
30+
### TenantLevelParameterSet
31+
```
32+
Get-PendingDelicenseUser [-ResultSize <Unlimited>] [-ShowDueObjectsOnly]
33+
[<CommonParameters>]
34+
```
35+
36+
## DESCRIPTION
37+
You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not 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).
38+
39+
## EXAMPLES
40+
41+
### Example 1
42+
```powershell
43+
Get-PendingDelicenseUser | Format-Table DisplayName,UserPrincipalName,WhenDueForDelicensingUTC
44+
```
45+
46+
This example returns a summary list of all mailboxes that have pending mailbox license removal requests.
47+
48+
### Example 2
49+
```powershell
50+
Get-PendingDelicenseUser -Identity yajvendra@contoso.onmicrosoft.com
51+
```
52+
53+
This example returns detailed information about the pending mailbox license removal request for the specified mailbox.
54+
55+
### Example 3
56+
```powershell
57+
Get-PendingDelicenseUser -ShowDueObjectsOnly | Format-Table DisplayName,UserPrincipalName,WhenDueForDelicensingUTC
58+
```
59+
60+
This example returns a summary list of all mailboxes where the 30 day delay for mailbox license removal requests has ended, so the licenses can be removed from the mailboxes at any time.
61+
62+
## PARAMETERS
63+
64+
### -Identity
65+
The Identity parameter specifies the mailbox with a pending mailbox license removal request.
66+
67+
You can use any value that uniquely identifies the mailbox. For example:
68+
69+
- Name
70+
- Alias
71+
- Distinguished name (DN)
72+
- Email address
73+
- GUID
74+
- LegacyExchangeDN
75+
- User ID or user principal name (UPN)
76+
77+
You can't use this parameter with the ShowDueObjectsOnly switch.
78+
79+
```yaml
80+
Type: RecipientIdParameter
81+
Parameter Sets: Identity
82+
Aliases:
83+
Applicable: Exchange Online
84+
85+
Required: False
86+
Position: 1
87+
Default value: None
88+
Accept pipeline input: False
89+
Accept wildcard characters: False
90+
```
91+
92+
### -ResultSize
93+
The ResultSize parameter specifies the maximum number of results to return. If you want to return all requests that match the query, use unlimited for the value of this parameter. The default value is 1000.
94+
95+
```yaml
96+
Type: Unlimited
97+
Parameter Sets: TenantLevelParameterSet
98+
Aliases:
99+
Applicable: Exchange Online
100+
101+
Required: False
102+
Position: Named
103+
Default value: None
104+
Accept pipeline input: False
105+
Accept wildcard characters: False
106+
```
107+
108+
### -ShowDueObjectsOnly
109+
The ShowDueObjectsOnly switch filters the results by mailboxes where the 30 day delay for removing the license has ended, and the license can be removed from the mailbox at any time. You don't need to specify a value with this switch.
110+
111+
You can't use this switch with the Identity parameter.
112+
113+
```yaml
114+
Type: SwitchParameter
115+
Parameter Sets: TenantLevelParameterSet
116+
Aliases:
117+
Applicable: Exchange Online
118+
119+
Required: False
120+
Position: Named
121+
Default value: False
122+
Accept pipeline input: False
123+
Accept wildcard characters: False
124+
```
125+
126+
### CommonParameters
127+
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).
128+
129+
## INPUTS
130+
131+
## OUTPUTS
132+
133+
## NOTES
134+
135+
## RELATED LINKS

exchange/exchange-ps/exchange/Get-SmtpDaneInboundStatus.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,6 @@ ms.reviewer:
1414
## SYNOPSIS
1515
This cmdlet is available only in the cloud-based service.
1616

17-
**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.
18-
1917
Use the Get-SmtpDaneInboundStatus cmdlet to view information about SMTP DNS-based Authentication of Named Entities (DANE) for inbound mail to accepted domains in Exchange Online.
2018

2119
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

exchange/exchange-ps/exchange/New-MailboxRestoreRequest.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -249,6 +249,17 @@ New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox "Tony Smit
249249

250250
In on-premises Exchange, this example restores the content of the source mailbox with the DisplayName of Tony Smith on mailbox database MBD01 to the archive mailbox for Tony@contoso.com.
251251

252+
### Example 3
253+
```powershell
254+
New-MailboxRestoreRequest -SourceMailbox 33948c06-c453-48be-bdb9-08eacd466f81 -TargetMailbox Tony@contoso.com -AllowLegacyDNMismatch
255+
```
256+
257+
In Exchange Online, this example restores the content of the inactive, disconnected, or soft deleted source mailbox to the active mailbox for Tony@contoso.com:
258+
259+
- The SourceMailbox value is the MailboxGUID value of an inactive, disconnected, or soft deleted mailbox.
260+
- The TargetMailbox value is the MailboxGUID or email address of the active target mailbox.
261+
- AllowLegacyDNMismatch allows copying data from one mailbox to another in this scenario.
262+
252263
## PARAMETERS
253264

254265
### -CrossTenantRestore

exchange/exchange-ps/exchange/New-TransportRule.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3270,7 +3270,7 @@ This parameter specifies an action or part of an action for the rule.
32703270

32713271
In on-premises Exchange, this action is available only on Mailbox servers.
32723272

3273-
The GenerateNotification parameter specifies an action that sends a notification message to recipients. For example, you can use this parameter to notify recipients that a message was rejected by the rule, or marked as spam and delivered to their Junk Email folder.
3273+
The GenerateNotification parameter specifies an action that sends a notification message to recipients that match the conditions of the rule. For example, you can use this parameter to notify recipients that a message was rejected by the rule, or marked as spam and delivered to their Junk Email folder. Each matched recipient receives a separate notification.
32743274

32753275
This parameter supports plain text, HTML tags and the following keywords that use values from the original message:
32763276

exchange/exchange-ps/exchange/Set-MailboxCalendarConfiguration.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -743,11 +743,11 @@ Accept wildcard characters: False
743743
### -LocationDetailsInFreeBusy
744744
This parameter is available only in the cloud-based service.
745745

746-
The LocationDetailsInFreeBusy parameter specifies the level of location details that are returned in user's availability. Valid values are:
746+
The LocationDetailsInFreeBusy parameter specifies the level of work location information that's returned as part of a user's availability. Work location information is visible across several Microsoft 365 application experiences, and the level of location information that's shown to other users in the organization is controlled by this parameter. Valid values are:
747747

748-
- None
749-
- Building
750-
- Desk
748+
- None: No location information is returned.
749+
- Building: Only Office or Remote are returned as work location information, if provided.
750+
- Desk: All work location information is returned, including Building and Desk, if provided. This is the default value.
751751

752752
```yaml
753753
Type: LocationDetailsPermissionInFreeBusy
@@ -757,7 +757,7 @@ Applicable: Exchange Online
757757
758758
Required: False
759759
Position: Named
760-
Default value: None
760+
Default value: Desk
761761
Accept pipeline input: False
762762
Accept wildcard characters: False
763763
```

0 commit comments

Comments
 (0)