Skip to content

Commit db1dced

Browse files
authored
Merge pull request #13287 from MicrosoftDocs/Identity-chrisda
Added Caution alert to Identity param 4
2 parents 48351c9 + 50ca1f6 commit db1dced

File tree

83 files changed

+166
-0
lines changed

Some content is hidden

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

83 files changed

+166
-0
lines changed

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,8 @@ The Identity parameter specifies the GUID or public folder name that represents
5252

5353
You can omit the parameter label so that only the public folder name or GUID is supplied.
5454

55+
**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.
56+
5557
```yaml
5658
Type: PublicFolderIdParameter
5759
Parameter Sets: (All)

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -110,6 +110,8 @@ The Identity parameter specifies the quarantined message that you want to view.
110110

111111
When you identify the quarantine message by using this parameter, the RecipientAddress, QuarantineUser, and ReleasedUser properties are available. To see these values, you need to use a formatting cmdlet. For example, `Get-QuarantineMessage -Identity <Identity> | Format-List`.
112112

113+
**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.
114+
113115
```yaml
114116
Type: QuarantineMessageIdentity
115117
Parameter Sets: Details

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,8 @@ The Identity parameter specifies the quarantined message that you want to view t
6161

6262
You can find the Identity value for a quarantined message by using the Get-QuarantineMessage cmdlet.
6363

64+
**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.
65+
6466
```yaml
6567
Type: QuarantineMessageIdentity
6668
Parameter Sets: (All)

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,8 @@ The Identity parameter specifies the quarantine policy you want to view. You can
6767
- Distinguished name (DN)
6868
- GUID
6969

70+
**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.
71+
7072
```yaml
7173
Type: QuarantineTagIdParameter
7274
Parameter Sets: (All)

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -93,6 +93,8 @@ This example lists only the external queues.
9393
9494
The Identity parameter specifies the queue. Valid input for this parameter uses the syntax Server\\Queue or Queue, for example, Mailbox01\\contoso.com or Unreachable. For details about queue identity, see [Queue identity](https://learn.microsoft.com/Exchange/mail-flow/queues/queues-and-messages-in-powershell#queue-identity).
9595

96+
**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.
97+
9698
```yaml
9799
Type: QueueIdentity
98100
Parameter Sets: Identity

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,8 @@ This example retrieves the Company Confidential RMS template.
5959
6060
The Identity parameter specifies the name of the RMS template.
6161

62+
**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.
63+
6264
```yaml
6365
Type: RmsTemplateIdParameter
6466
Parameter Sets: (All)

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,8 @@ The Identity parameter specifies the Receive connector that you want to view. Yo
7171

7272
You can't use this parameter with the Server parameter.
7373

74+
**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.
75+
7476
```yaml
7577
Type: ReceiveConnectorIdParameter
7678
Parameter Sets: Identity

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -157,6 +157,8 @@ The Identity parameter specifies the recipient object that you want to view. You
157157
- Email address
158158
- GUID
159159

160+
**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.
161+
160162
```yaml
161163
Type: RecipientIdParameter
162164
Parameter Sets: Identity

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,8 @@ This example returns detailed information about the recipient filter configurati
4747
4848
This parameter is reserved for internal Microsoft use.
4949

50+
**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.
51+
5052
```yaml
5153
Type: OrganizationIdParameter
5254
Parameter Sets: (All)

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,8 @@ You can use any value that uniquely identifies the recipient. For example:
7979
- Email address
8080
- GUID
8181

82+
**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.
83+
8284
```yaml
8385
Type: RecipientIdParameter
8486
Parameter Sets: (All)

0 commit comments

Comments
 (0)