Skip to content

Commit e122223

Browse files
committed
Import/Export-TransportRuleCollection updates
1 parent 1807686 commit e122223

File tree

2 files changed

+39
-4
lines changed

2 files changed

+39
-4
lines changed

exchange/exchange-ps/exchange/Export-TransportRuleCollection.md

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ For information about the parameter sets in the Syntax section below, see [Excha
2424
Export-TransportRuleCollection [[-Identity] <RuleIdParameter>]
2525
[-Confirm]
2626
[-DomainController <Fqdn>]
27+
[-Format <RuleCollectionFormat>]
2728
[-ExportLegacyRules]
2829
[-WhatIf]
2930
[<CommonParameters>]
@@ -61,7 +62,11 @@ In Exchange Server 2010, this example exports legacy transport rules created in
6162
### -Identity
6263
This cmdlet is available only in on-premises Exchange, and is functional only in Exchange Server 2010.
6364

64-
The Identity parameter specifies the name or GUID of a transport rule to be exported.
65+
The Identity parameter specifies the transport rule that you want to export. You can use any value that uniquely identifies the rule. For example:
66+
67+
- Name
68+
- Distinguished name (DN)
69+
- GUID
6570

6671
```yaml
6772
Type: RuleIdParameter
@@ -133,6 +138,28 @@ Accept pipeline input: False
133138
Accept wildcard characters: False
134139
```
135140

141+
### -Format
142+
This parameter is available only in the cloud-based service.
143+
144+
The Format parameter specifics the format of the exported transport rule collection. Valid values are:
145+
146+
- RuleCollectionXML
147+
- InternalXML
148+
- DlpMigrationRuleCollection
149+
150+
```yaml
151+
Type: RuleCollectionFormat
152+
Parameter Sets: (All)
153+
Aliases:
154+
Applicable: Exchange Online
155+
156+
Required: False
157+
Position: Named
158+
Default value: None
159+
Accept pipeline input: False
160+
Accept wildcard characters: False
161+
```
162+
136163
### -WhatIf
137164
The WhatIf switch simulates the actions of the command. You can use this switch to view the changes that would occur without actually applying those changes. You don't need to specify a value with this switch.
138165

exchange/exchange-ps/exchange/Import-TransportRuleCollection.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
4646
Import-TransportRuleCollection -FileData $Data
4747
```
4848

49-
This example imports a transport rule collection from the XML file named ExportedRules.xml in the C:\\TransportRules folder.
49+
This example imports a transport rule collection from the XML file named ExportedRules.xml in the C:\\TransportRules folder.
5050

5151
**Note**: In PowerShell 6.0 or later, replace `-Encoding Byte` with `-AsByteStream`.
5252

@@ -55,7 +55,11 @@ This example imports a transport rule collection from the XML file named Exporte
5555
### -Identity
5656
This cmdlet is available only in on-premises Exchange, and is only functional in Exchange Server 2010.
5757

58-
The Identity parameter specifies the transport rule to be imported. Use either the GUID or the name of the rule. You can omit the parameter label.
58+
The Identity parameter specifies the transport rule that you want to import. You can use any value that uniquely identifies the rule. For example:
59+
60+
- Name
61+
- Distinguished name (DN)
62+
- GUID
5963

6064
```yaml
6165
Type: RuleIdParameter
@@ -71,7 +75,11 @@ Accept wildcard characters: False
7175
```
7276
7377
### -FileData
74-
The FileData parameter specifies the variable name that contains the content of the XML file. The content is retrieved using the Get-Content cmdlet.
78+
The FileData parameter specifies the variable name that contains the content of the XML file.
79+
80+
A valid value for this parameter requires you to read the file to a byte-encoded object using the Get-Content cmdlet. For example, `(Get-Content -Encoding Byte -Path "C:\My Documents\<filename>" -ReadCount 0)`.
81+
82+
**Note**: In PowerShell 6.0 or later, replace `-Encoding Byte` with `-AsByteStream`.
7583

7684
```yaml
7785
Type: Byte[]

0 commit comments

Comments
 (0)