Merge branch 'main' into CPC-chrisda

chrisda · chrisda · commit e826894b67eb · 2025-07-02T13:33:45.000-07:00
diff --git a/exchange/exchange-ps/exchange/Get-DistributionGroup.md b/exchange/exchange-ps/exchange/Get-DistributionGroup.md
@@ -32,6 +32,7 @@ Get-DistributionGroup [-Anr <String>]
  [-IncludeAcceptMessagesOnlyFromWithDisplayNames]
  [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
  [-IncludeGrantSendOnBehalfToWithDisplayNames]
+ [-IncludeManagedByWithDisplayNames]
  [-IncludeModeratedByWithDisplayNames]
  [-OrganizationalUnit <OrganizationalUnitIdParameter>]
  [-ReadFromDomainController]
@@ -52,6 +53,7 @@ Get-DistributionGroup [[-Identity] <DistributionGroupIdParameter>]
  [-IncludeAcceptMessagesOnlyFromWithDisplayNames]
  [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
  [-IncludeGrantSendOnBehalfToWithDisplayNames]
+ [-IncludeManagedByWithDisplayNames]
  [-IncludeModeratedByWithDisplayNames]
  [-OrganizationalUnit <OrganizationalUnitIdParameter>]
  [-ReadFromDomainController]
@@ -71,6 +73,7 @@ Get-DistributionGroup [-Credential <PSCredential>]
  [-IncludeAcceptMessagesOnlyFromWithDisplayNames]
  [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
  [-IncludeGrantSendOnBehalfToWithDisplayNames]
+ [-IncludeManagedByWithDisplayNames]
  [-IncludeModeratedByWithDisplayNames]
  [-ManagedBy <GeneralRecipientIdParameter>]
  [-OrganizationalUnit <OrganizationalUnitIdParameter>]
@@ -337,6 +340,26 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -IncludeManagedByWithDisplayNames
+This parameter is available only in the cloud-based service.
+
+The IncludeManagedByWithDisplayNames switch specifies whether to return the SMTP addresses and display names of group owners in the ManagedByWithDisplayNames property. You don't need to specify a value with this switch.
+
+This switch was introduced to restore human-readable identifiers in the results of the cmdlet. If you don't use this switch, the ManagedByWithDisplayNames property is empty.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+Applicable: Exchange Online
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -IncludeModeratedByWithDisplayNames
 This parameter is available only in the cloud-based service.
 
diff --git a/exchange/exchange-ps/exchange/Get-DynamicDistributionGroup.md b/exchange/exchange-ps/exchange/Get-DynamicDistributionGroup.md
@@ -31,6 +31,7 @@ Get-DynamicDistributionGroup [-Anr <String>]
  [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
  [-IncludeAcceptMessagesOnlyFromWithDisplayNames]
  [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
+ [-IncludeManagedByWithDisplayNames]
  [-IncludeGrantSendOnBehalfToWithDisplayNames]
  [-IncludeModeratedByWithDisplayNames]
  [-IncludeSystemObjects]
@@ -53,6 +54,7 @@ Get-DynamicDistributionGroup [[-Identity] <DynamicGroupIdParameter>]
  [-IncludeAcceptMessagesOnlyFromWithDisplayNames]
  [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
  [-IncludeGrantSendOnBehalfToWithDisplayNames]
+ [-IncludeManagedByWithDisplayNames]
  [-IncludeModeratedByWithDisplayNames]
  [-IncludeSystemObjects]
  [-OrganizationalUnit <OrganizationalUnitIdParameter>]
@@ -74,6 +76,7 @@ Get-DynamicDistributionGroup [-ManagedBy <GeneralRecipientIdParameter>]
  [-IncludeAcceptMessagesOnlyFromWithDisplayNames]
  [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
  [-IncludeGrantSendOnBehalfToWithDisplayNames]
+ [-IncludeManagedByWithDisplayNames]
  [-IncludeModeratedByWithDisplayNames]
  [-IncludeSystemObjects]
  [-OrganizationalUnit <OrganizationalUnitIdParameter>]
@@ -351,6 +354,26 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -IncludeManagedByWithDisplayNames
+This parameter is available only in the cloud-based service.
+
+The IncludeManagedByWithDisplayNames switch specifies whether to return the SMTP addresses and display names of group owners in the ManagedByWithDisplayNames property. You don't need to specify a value with this switch.
+
+This switch was introduced to restore human-readable identifiers in the results of the cmdlet. If you don't use this switch, the ManagedByWithDisplayNames property is empty.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+Applicable: Exchange Online
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -IncludeModeratedByWithDisplayNames
 This parameter is available only in the cloud-based service.
 
diff --git a/exchange/exchange-ps/exchange/New-ComplianceTag.md b/exchange/exchange-ps/exchange/New-ComplianceTag.md
@@ -91,9 +91,7 @@ Accept wildcard characters: False
 ```
 
 ### -PriorityCleanup
-The PriorityCleanup switch specifies whether to create a tag associated with a Priority cleanup policy. You don't need to specify a value with this switch.
-
-Priority cleanup policies expedite the deletion of sensitive content by overriding any existing retention settings or eDiscovery holds. For more information, see [Priority Cleanup](https://learn.microsoft.com/purview/priority-cleanup).
+{{ Fill PriorityCleanup Description }}
 
 ```yaml
 Type: SwitchParameter
diff --git a/exchange/exchange-ps/exchange/New-ProtectionAlert.md b/exchange/exchange-ps/exchange/New-ProtectionAlert.md
@@ -186,6 +186,8 @@ The AlertBy parameter specifies the scope for aggregated alert policies. Valid v
 
 You can't use this parameter when the AggregationType parameter value is None (alerts are triggered for every occurrence of the activity).
 
+**Note**: This parameter is required to show entities in alerts. Without it, alerts trigger without showing entities. We strongly recommend specifying a value for this parameter.
+
 ```yaml
 Type: MultiValuedProperty
 Parameter Sets: (All)
diff --git a/exchange/exchange-ps/exchange/Set-ComplianceTag.md b/exchange/exchange-ps/exchange/Set-ComplianceTag.md
@@ -300,9 +300,7 @@ Accept wildcard characters: False
 ```
 
 ### -PriorityCleanup
-The PriorityCleanup switch specifies whether to update the tag associated with a Priority cleanup policy. You don't need to specify a value with this switch.
-
-Priority cleanup policies expedite the deletion of sensitive content by overriding any existing retention settings or eDiscovery holds. For more information, see [Priority Cleanup](https://learn.microsoft.com/purview/priority-cleanup).
+{{ Fill PriorityCleanup Description }}
 
 ```yaml
 Type: SwitchParameter
diff --git a/exchange/exchange-ps/exchange/Set-ProtectionAlert.md b/exchange/exchange-ps/exchange/Set-ProtectionAlert.md
@@ -121,6 +121,8 @@ The AlertBy parameter specifies the scope for aggregated alert policies. Valid v
 
 You can't use this parameter when the AggregationType parameter value is None (alerts are triggered for every occurrence of the activity).
 
+**Note**: This parameter is required to show entities in alerts. Without it, alerts trigger without showing entities. We strongly recommend specifying a value for this parameter.
+
 ```yaml
 Type: MultiValuedProperty
 Parameter Sets: (All)
