Skip to content

Commit 8b47db5

Browse files
chrisdachrisda
committed
Merge branch 'main' into Connect-chrisda
2 parents 38b4b15 + 5deb554 commit 8b47db5

File tree

170 files changed

+1859
-731
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

170 files changed

+1859
-731
lines changed

‎.openpublishing.build.ps1

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

‎exchange/exchange-ps/exchange/Expedite-Delicensing.md

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 [email protected]
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-App.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,8 @@ The Mailbox parameter specifies the identity of the mailbox where the apps are i
109109
110110
You can't use this parameter with the Identity parameter.
111111
112+
Note: This parameter only returns user installed and default add-ins. It doesn't return add-ins installed by admins from Integrated Apps. For more information, see [Deploy and manage Office Add-ins](https://learn.microsoft.com/microsoft-365/admin/manage/office-addins).
113+
112114
```yaml
113115
Type: MailboxIdParameter
114116
Parameter Sets: (All)

‎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

‎exchange/exchange-ps/exchange/Get-MailUser.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -52,9 +52,9 @@ Get-MailUser [[-Identity] <MailUserIdParameter>]
5252
[<CommonParameters>]
5353
```
5454

55-
### LOBAppAccount
55+
### HVEAccount
5656
```
57-
Get-MailUser [-LOBAppAccount]
57+
Get-MailUser [-HVEAccount]
5858
[-Filter <String>]
5959
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
6060
[-ResultSize <Unlimited>]
@@ -216,20 +216,20 @@ Accept pipeline input: false
216216
Accept wildcard characters: False
217217
```
218218

219-
### -LOBAppAccount
219+
### -HVEAccount
220220
This parameter is available only in the cloud-based service.
221221

222-
{{ Fill LOBAppAccount Description }}
222+
The HVEAccount switch specifies that this mail user account is specifically used for the [High volume email service](https://learn.microsoft.com/exchange/mail-flow-best-practices/high-volume-mails-m365). You don't need to specify a value with this switch.
223223

224224
```yaml
225225
Type: SwitchParameter
226226
Parameter Sets: LOBAppAccount
227227
Aliases:
228228
Applicable: Exchange Online, Exchange Online Protection
229229
230-
Required: False
231230
Position: Named
232231
Default value: None
232+
Required: False
233233
Accept pipeline input: False
234234
Accept wildcard characters: False
235235
```

‎exchange/exchange-ps/exchange/Get-PendingDelicenseUser.md

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 [email protected]
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/New-ApplicationAccessPolicy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -123,7 +123,7 @@ Accept wildcard characters: False
123123
```
124124
125125
### -PolicyScopeGroupID
126-
The PolicyScopeGroupID parameter specifies the recipient to define in the policy. Valid recipient types are security principals in Exchange Online (users or groups that can have permissions assigned to them). For example:
126+
The PolicyScopeGroupID parameter specifies the recipient to define in the policy. Valid recipient types are security principals in Exchange Online (users or groups, including nested groups, that can have permissions assigned to them). For example:
127127
128128
- Mailboxes with associated user accounts (UserMailbox)
129129
- Mail users, also known as mail-enabled users (MailUser)

‎exchange/exchange-ps/exchange/New-ComplianceSearchAction.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -451,6 +451,9 @@ Accept wildcard characters: False
451451
The Purge switch specifies the action for the content search is to remove items that match the search criteria. You don't need to specify a value with this switch.
452452

453453
- A maximum of 10 items per mailbox can be removed at one time. Because the capability to search for and remove messages is intended to be an incident-response tool, this limit helps ensure that messages are quickly removed from mailboxes. This action isn't intended to clean up user mailboxes.
454+
455+
**Tip**: To purge more than 10 items, refer to [ediscoverySearch: purgeData](https://learn.microsoft.com/graph/api/security-ediscoverysearch-purgedata) in the Microsoft Graph API, which allows purging a maximum of 100 items per location.
456+
454457
- You can remove items from a maximum of 50,000 mailboxes using a single content search. To remove items from more than 50,000 mailboxes, you'll have to create separate content searches. For more information, see [Search for and delete email messages in your Microsoft 365 organization](https://learn.microsoft.com/purview/ediscovery-search-for-and-delete-email-messages).
455458
- Unindexed items aren't removed from mailboxes when you use this switch.
456459
- The value of the PurgeType parameter controls how the items are removed.

‎exchange/exchange-ps/exchange/New-MailUser.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -127,7 +127,7 @@ New-MailUser [-Name] <String> -FederatedIdentity <String>
127127

128128
### LOBAppAccount
129129
```
130-
New-MailUser [-Name] <String> -Password <SecureString> [-LOBAppAccount]
130+
New-MailUser [-Name] <String> -Password <SecureString> [-HVEAccount]
131131
[-Alias <String>]
132132
[-Confirm]
133133
[-DisplayName <String>]
@@ -531,20 +531,20 @@ Accept pipeline input: False
531531
Accept wildcard characters: False
532532
```
533533

534-
### -LOBAppAccount
534+
### -HVEAccount
535535
This parameter is available only in the cloud-based service.
536536

537-
{{ Fill LOBAppAccount Description }}
537+
The HVEAccount switch specifies that this mail user account is specifically used for the [High volume email service](https://learn.microsoft.com/exchange/mail-flow-best-practices/high-volume-mails-m365). You don't need to specify a value with this switch.
538538

539539
```yaml
540540
Type: SwitchParameter
541-
Parameter Sets: LOBAppAccount
541+
Parameter Sets: HVEAccount
542542
Aliases:
543543
Applicable: Exchange Online, Exchange Online Protection
544544
545-
Required: False
546545
Position: Named
547546
Default value: None
547+
Required: False
548548
Accept pipeline input: False
549549
Accept wildcard characters: False
550550
```

0 commit comments

Comments
 (0)