Skip to content

Patch 839316 #12301

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Nov 7, 2024
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
17 changes: 0 additions & 17 deletions .openpublishing.build.ps1

This file was deleted.

2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Contributors who make infrequent or small updates can edit the file directly on
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/).

> [!TIP]
> 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).
> 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).

Select **Preview** to view your changes as you go. Select **Edit** to go back to making updates.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,6 @@ ms.reviewer:
## SYNOPSIS
This cmdlet is available only in the cloud-based service.

**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.

Use the Disable-DnssecForVerifiedDomain cmdlet to disable Domain Name System Security (DNSSEC) for inbound mail to accepted domains in Exchange Online.

For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
Expand Down
2 changes: 0 additions & 2 deletions exchange/exchange-ps/exchange/Disable-SmtpDaneInbound.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,6 @@ ms.reviewer:
## SYNOPSIS
This cmdlet is available only in the cloud-based service.

**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.

Use the Disable-SMTPDaneInbound cmdlet to disable SMTP DNS-based Authentication of Named Entities (DANE) for inbound mail to accepted domains in Exchange Online.

For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,6 @@ ms.reviewer:
## SYNOPSIS
This cmdlet is available only in the cloud-based service.

**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.

Use the Enable-DnssecForVerifiedDomain cmdlet to enable Domain Name System Security (DNSSEC) for inbound mail to accepted domains in Exchange Online.

For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
Expand Down
2 changes: 0 additions & 2 deletions exchange/exchange-ps/exchange/Enable-SmtpDaneInbound.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,6 @@ ms.reviewer:
## SYNOPSIS
This cmdlet is available only in the cloud-based service.

**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.

Use the Enable-SMTPDaneInbound cmdlet to enable SMTP DNS-based Authentication of Named Entities (DANE) for inbound mail to accepted domains in Exchange Online.

For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
Expand Down
77 changes: 77 additions & 0 deletions exchange/exchange-ps/exchange/Expedite-Delicensing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
---
external help file: Microsoft.Exchange.RolesAndAccess-Help.xml
online version: https://learn.microsoft.com/powershell/module/exchange/expedite-delicensing
applicable: Exchange Online
title: Expedite-Delicensing
schema: 2.0.0
author: chrisda
ms.author: chrisda
ms.reviewer:
---

# Expedite-Delicensing

## SYNOPSIS
This cmdlet is available only in the cloud-based service.

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.

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

## SYNTAX

```
Expedite-Delicensing [-Identity] <RecipientIdParameter>
[<CommonParameters>]
```

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

## EXAMPLES

### Example 1
```powershell
Expedite-Delicensing -Identity yajvendra@contoso.onmicrosoft.com
```

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.

## PARAMETERS

### -Identity
The Identity parameter specifies the mailbox with a pending mailbox license removal request.

You can use any value that uniquely identifies the mailbox. For example:

- Name
- Alias
- Distinguished name (DN)
- Email address
- GUID
- LegacyExchangeDN
- User ID or user principal name (UPN)

```yaml
Type: RecipientIdParameter
Parameter Sets: (All)
Aliases:
Applicable: Exchange Online

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

### CommonParameters
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).

## INPUTS

## OUTPUTS

## NOTES

## RELATED LINKS
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,6 @@ ms.reviewer:
## SYNOPSIS
This cmdlet is available only in the cloud-based service.

**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.

Use the Get-DnssecStatusForVerifiedDomain cmdlet to view information about Domain Name System Security (DNSSEC) for accepted domains in Exchange Online.

For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
Expand Down
2 changes: 1 addition & 1 deletion exchange/exchange-ps/exchange/Get-EXOMailboxStatistics.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ This example retrieves the minimum set of properties and the specified propertie
## PARAMETERS

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

```yaml
Type: SwitchParameter
Expand Down
16 changes: 13 additions & 3 deletions exchange/exchange-ps/exchange/Get-IPv6StatusForAcceptedDomain.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,9 +35,16 @@ If IPv6 is enabled for an accepted domain in Exchange Online, IPv4 and IPv6 addr
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).

> [!NOTE]
> 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.
>
> 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.
> - 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.
>
> 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.
>
> - If you receive the following error when running Get-Ipv6StatusForAcceptedDomain:
>
> WARNING: DNS record has unexpected value…..
>
> Explicitly enable or disable IPv6 using the Enable-Ipv6ForAcceptedDomain or Disable-Ipv6ForAcceptedDomain cmdlets.

## EXAMPLES

Expand Down Expand Up @@ -101,7 +108,10 @@ Accept wildcard characters: False
### CommonParameters
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).

## INPUTS

## OUTPUTS

## NOTES


## RELATED LINKS
135 changes: 135 additions & 0 deletions exchange/exchange-ps/exchange/Get-PendingDelicenseUser.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,135 @@
---
external help file: Microsoft.Exchange.RolesAndAccess-Help.xml
online version: https://learn.microsoft.com/powershell/module/exchange/get-pendingdelicenseuser
applicable: Exchange Online
title: Get-PendingDelicenseUser
schema: 2.0.0
author: chrisda
ms.author: chrisda
ms.reviewer:
---


# Get-PendingDelicenseUser

## SYNOPSIS
This cmdlet is available only in the cloud-based service.

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.

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

## SYNTAX

### Identity (Default)
```
Get-PendingDelicenseUser [[-Identity] <RecipientIdParameter>]
[<CommonParameters>]
```

### TenantLevelParameterSet
```
Get-PendingDelicenseUser [-ResultSize <Unlimited>] [-ShowDueObjectsOnly]
[<CommonParameters>]
```

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

## EXAMPLES

### Example 1
```powershell
Get-PendingDelicenseUser | Format-Table DisplayName,UserPrincipalName,WhenDueForDelicensingUTC
```

This example returns a summary list of all mailboxes that have pending mailbox license removal requests.

### Example 2
```powershell
Get-PendingDelicenseUser -Identity yajvendra@contoso.onmicrosoft.com
```

This example returns detailed information about the pending mailbox license removal request for the specified mailbox.

### Example 3
```powershell
Get-PendingDelicenseUser -ShowDueObjectsOnly | Format-Table DisplayName,UserPrincipalName,WhenDueForDelicensingUTC
```

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.

## PARAMETERS

### -Identity
The Identity parameter specifies the mailbox with a pending mailbox license removal request.

You can use any value that uniquely identifies the mailbox. For example:

- Name
- Alias
- Distinguished name (DN)
- Email address
- GUID
- LegacyExchangeDN
- User ID or user principal name (UPN)

You can't use this parameter with the ShowDueObjectsOnly switch.

```yaml
Type: RecipientIdParameter
Parameter Sets: Identity
Aliases:
Applicable: Exchange Online

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

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

```yaml
Type: Unlimited
Parameter Sets: TenantLevelParameterSet
Aliases:
Applicable: Exchange Online

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

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

You can't use this switch with the Identity parameter.

```yaml
Type: SwitchParameter
Parameter Sets: TenantLevelParameterSet
Aliases:
Applicable: Exchange Online

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

### CommonParameters
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).

## INPUTS

## OUTPUTS

## NOTES

## RELATED LINKS
2 changes: 0 additions & 2 deletions exchange/exchange-ps/exchange/Get-SmtpDaneInboundStatus.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,6 @@ ms.reviewer:
## SYNOPSIS
This cmdlet is available only in the cloud-based service.

**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.

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.

For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
Expand Down
11 changes: 11 additions & 0 deletions exchange/exchange-ps/exchange/New-MailboxRestoreRequest.md
Original file line number Diff line number Diff line change
Expand Up @@ -249,6 +249,17 @@ New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox "Tony Smit

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.

### Example 3
```powershell
New-MailboxRestoreRequest -SourceMailbox 33948c06-c453-48be-bdb9-08eacd466f81 -TargetMailbox Tony@contoso.com -AllowLegacyDNMismatch
```

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:

- The SourceMailbox value is the MailboxGUID value of an inactive, disconnected, or soft deleted mailbox.
- The TargetMailbox value is the MailboxGUID or email address of the active target mailbox.
- AllowLegacyDNMismatch allows copying data from one mailbox to another in this scenario.

## PARAMETERS

### -CrossTenantRestore
Expand Down
2 changes: 1 addition & 1 deletion exchange/exchange-ps/exchange/New-TransportRule.md
Original file line number Diff line number Diff line change
Expand Up @@ -3270,7 +3270,7 @@ This parameter specifies an action or part of an action for the rule.

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

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

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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -743,11 +743,11 @@ Accept wildcard characters: False
### -LocationDetailsInFreeBusy
This parameter is available only in the cloud-based service.

The LocationDetailsInFreeBusy parameter specifies the level of location details that are returned in user's availability. Valid values are:
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:

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

```yaml
Type: LocationDetailsPermissionInFreeBusy
Expand All @@ -757,7 +757,7 @@ Applicable: Exchange Online

Required: False
Position: Named
Default value: None
Default value: Desk
Accept pipeline input: False
Accept wildcard characters: False
```
Expand Down
Loading