Merge branch 'main' into add-compliance-hold-documentation

Author: chrisda

.openpublishing.redirection.exchange.json

@@ -997,7 +997,7 @@
         },
         {
             "source_path": "exchange/virtual-folder/exchange/client-access/New-ClientAccessRule.md",
-            "redirect_url": "https://techcommunity.microsoft.com/blog/exchange/update-on-client-access-rules-deprecation-in-exchange-online/4354809",
+            "redirect_url": "/powershell/module/exchangepowershell/new-clientaccessrule",
             "redirect_document_id": false
         },
         {
@@ -10372,7 +10372,7 @@
         },
         {
             "source_path": "exchange/virtual-folder/exchange/New-ClientAccessRule.md",
-            "redirect_url": "https://techcommunity.microsoft.com/blog/exchange/update-on-client-access-rules-deprecation-in-exchange-online/4354809",
+            "redirect_url": "/powershell/module/exchangepowershell/new-clientaccessrule",
             "redirect_document_id": false
         },
         {
@@ -14234,11 +14234,6 @@
             "source_path": "exchange/virtual-folder/exchange/Write-AdminAuditLog.md",
             "redirect_url": "/powershell/module/exchangepowershell/write-adminauditlog",
             "redirect_document_id": true
-        },
-        {
-            "source_path": "exchange/virtual-folder/exchangepowershell/New-ClientAccessRule.md",
-            "redirect_url": "https://techcommunity.microsoft.com/blog/exchange/update-on-client-access-rules-deprecation-in-exchange-online/4354809",
-            "redirect_document_id": false
         }
     ]
 }

exchange/exchange-ps/ExchangePowerShell/ExchangePowerShell.md

@@ -504,6 +504,8 @@ Exchange PowerShell is built on PowerShell technology to a powerful command-line
 
 ### [Get-TextMessagingAccount](Get-TextMessagingAccount.md)
 
+### [New-ClientAccessRule](New-ClientAccessRule.md)
+
 ### [New-OutlookProvider](New-OutlookProvider.md)
 
 ### [New-OwaMailboxPolicy](New-OwaMailboxPolicy.md)

exchange/exchange-ps/ExchangePowerShell/Get-ADPermission.md

@@ -66,6 +66,8 @@ This example returns the permissions that have been granted to the user Chris on
 
 The Identity parameter specifies the identity of the object for which you're retrieving permissions. You can retrieve the permissions for any Active Directory object using its distinguished name (DN). If the object is an Exchange object, you might be able to use the object's name. If the DN or the object's name contains spaces, enclose the value in quotation marks (").
 
+**Caution**: The value $null or a non-existent value for the Identity parameter returns *all* objects as if you ran the Get- command without the Identity parameter. Verify any lists of values for the Identity parameter are accurate and don't contain non-existent $null values.
+
 ```yaml
 Type: ADRawEntryIdParameter
 Parameter Sets: (All)

exchange/exchange-ps/ExchangePowerShell/Get-ADSite.md

@@ -49,6 +49,8 @@ This example displays the configuration details for the Active Directory site na
 
 The Identity parameter specifies the identity of the Active Directory site for which you want to view configuration details. The identity can be expressed as a GUID or the Active Directory site name. If the Active Directory site name includes spaces, enclose the name in quotation marks (").
 
+**Caution**: The value $null or a non-existent value for the Identity parameter returns *all* objects as if you ran the Get- command without the Identity parameter. Verify any lists of values for the Identity parameter are accurate and don't contain non-existent $null values.
+
 ```yaml
 Type: AdSiteIdParameter
 Parameter Sets: (All)

exchange/exchange-ps/ExchangePowerShell/Get-ADSiteLink.md

@@ -54,6 +54,8 @@ This example returns a list of all IP site links in your organization that have
 
 The Identity parameter specifies the name or GUID of the IP site link for which you want to view configuration information.
 
+**Caution**: The value $null or a non-existent value for the Identity parameter returns *all* objects as if you ran the Get- command without the Identity parameter. Verify any lists of values for the Identity parameter are accurate and don't contain non-existent $null values.
+
 ```yaml
 Type: AdSiteLinkIdParameter
 Parameter Sets: (All)

exchange/exchange-ps/ExchangePowerShell/Get-ATPBuiltInProtectionRule.md

@@ -53,6 +53,8 @@ The Identity parameter specifies the rule that you want to view. You can use any
 
 The name of the only rule is ATP Built-In Protection Rule.
 
+**Caution**: The value $null or a non-existent value for the Identity parameter returns *all* objects as if you ran the Get- command without the Identity parameter. Verify any lists of values for the Identity parameter are accurate and don't contain non-existent $null values.
+
 ```yaml
 Type: DehydrateableRuleIdParameter
 Parameter Sets: (All)

exchange/exchange-ps/ExchangePowerShell/Get-ATPProtectionPolicyRule.md

@@ -62,6 +62,8 @@ The Identity parameter specifies the rule that you want to view. You can use any
 
 By default, the available rules (if they exist) are named Standard Preset Security Policy and Strict Preset Security Policy.
 
+**Caution**: The value $null or a non-existent value for the Identity parameter returns *all* objects as if you ran the Get- command without the Identity parameter. Verify any lists of values for the Identity parameter are accurate and don't contain non-existent $null values.
+
 ```yaml
 Type: RuleIdParameter
 Parameter Sets: (All)

exchange/exchange-ps/ExchangePowerShell/Get-AcceptedDomain.md

@@ -55,6 +55,8 @@ This example lists all the authoritative accepted domains in your organization.
 
 The Identity parameter specifies a string value for the accepted domain. Enter either the GUID or the name of the accepted domain.
 
+**Caution**: The value $null or a non-existent value for the Identity parameter returns *all* objects as if you ran the Get- command without the Identity parameter. Verify any lists of values for the Identity parameter are accurate and don't contain non-existent $null values.
+
 ```yaml
 Type: AcceptedDomainIdParameter
 Parameter Sets: (All)

exchange/exchange-ps/ExchangePowerShell/Get-ActiveSyncDevice.md

@@ -87,6 +87,8 @@ The Identity parameter specifies the ActiveSync device that you want to view. Yo
 - DeviceIdentity
 - Multi-TenantID
 
+**Caution**: The value $null or a non-existent value for the Identity parameter returns *all* objects as if you ran the Get- command without the Identity parameter. Verify any lists of values for the Identity parameter are accurate and don't contain non-existent $null values.
+
 ```yaml
 Type: ActiveSyncDeviceIdParameter
 Parameter Sets: Identity

exchange/exchange-ps/ExchangePowerShell/Get-ActiveSyncDeviceAccessRule.md

@@ -56,6 +56,8 @@ This example lists all device access rules set up on the server.
 
 The Identity parameter specifies the unique identifier for the device access rule.
 
+**Caution**: The value $null or a non-existent value for the Identity parameter returns *all* objects as if you ran the Get- command without the Identity parameter. Verify any lists of values for the Identity parameter are accurate and don't contain non-existent $null values.
+
 ```yaml
 Type: ActiveSyncDeviceAccessRuleIdParameter
 Parameter Sets: (All)