Skip to content

Commit 16f7379

Browse files
lusassl-msftlusassl-msft
committed
Feature Flighting cmdlets and parameters added
1 parent 5bc7dd3 commit 16f7379

File tree

3 files changed

+289
-0
lines changed

3 files changed

+289
-0
lines changed

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

Lines changed: 133 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,133 @@
1+
---
2+
external help file: Microsoft.Exchange.ServerStatus-Help.xml
3+
online version: https://learn.microsoft.com/powershell/module/exchange/get-exchangefeature
4+
applicable: Exchange Server 2019
5+
title: Get-ExchangeFeature
6+
schema: 2.0.0
7+
author: lusassl-msft
8+
ms.author: lusassl
9+
ms.reviewer: srvar
10+
---
11+
12+
# Get-ExchangeFeature
13+
14+
## SYNOPSIS
15+
This cmdlet is available only in on-premises Exchange.
16+
17+
Use the Get-ExchangeFeature cmdlet to return information about features that are flighted on Exchange servers.
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+
Get-ExchangeFeature [-FeatureID <Microsoft.Exchange.Data.MultiValuedProperty`1[System.String]>]
25+
[-Identity <ServerIdParameter>]
26+
[-RingLevel <String>]
27+
[-Status <String>]
28+
```
29+
30+
## DESCRIPTION
31+
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).
32+
33+
## EXAMPLES
34+
35+
### Example 1
36+
```powershell
37+
PS C:\> Get-ExchangeFeature -Status "Enabled"
38+
```
39+
40+
This command returns all enabled features.
41+
42+
### Example 2
43+
```powershell
44+
PS C:\> Get-ExchangeFeature -FeatureID "PING.1.0"
45+
```
46+
47+
This command returns information about the feature with the feature id PING.1.0.
48+
49+
## PARAMETERS
50+
51+
### -FeatureID
52+
The FeatureID parameter specifies the feature you want to query information about.
53+
54+
```yaml
55+
Type: Microsoft.Exchange.Data.MultiValuedProperty`1[System.String]
56+
Parameter Sets: (All)
57+
Aliases:
58+
59+
Required: False
60+
Position: Named
61+
Default value: None
62+
Accept pipeline input: False
63+
Accept wildcard characters: False
64+
```
65+
66+
### -Identity
67+
The Identity parameter specifies the Exchange server that you want to modify. You can use any value that uniquely identifies the server. For example:
68+
69+
- Name
70+
- FQDN
71+
- Distinguished name (DN)
72+
- Exchange Legacy DN
73+
74+
If you don't use this parameter, the command returns information for all Exchange servers.
75+
76+
```yaml
77+
Type: ServerIdParameter
78+
Parameter Sets: (All)
79+
Aliases:
80+
81+
Required: False
82+
Position: 0
83+
Default value: None
84+
Accept pipeline input: True (ByPropertyName, ByValue)
85+
Accept wildcard characters: False
86+
```
87+
88+
### -RingLevel
89+
The RingLevel parameter specifies the ring level you want to query information about.
90+
91+
```yaml
92+
Type: String
93+
Parameter Sets: (All)
94+
Aliases:
95+
96+
Required: False
97+
Position: Named
98+
Default value: None
99+
Accept pipeline input: False
100+
Accept wildcard characters: False
101+
```
102+
103+
### -Status
104+
The Status parameter specifies the status you want to query information about.
105+
106+
```yaml
107+
Type: String
108+
Parameter Sets: (All)
109+
Aliases:
110+
111+
Required: False
112+
Position: Named
113+
Default value: None
114+
Accept pipeline input: False
115+
Accept wildcard characters: False
116+
```
117+
118+
### CommonParameters
119+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
120+
121+
## INPUTS
122+
123+
### Input types
124+
To see the input types that this cmdlet accepts, see [Cmdlet Input and Output Types](https://go.microsoft.com/fwlink/p/?LinkId=616387). If the Input Type field for a cmdlet is blank, the cmdlet doesn't accept input data.
125+
126+
## OUTPUTS
127+
128+
### Output types
129+
To see the return types, which are also known as output types, that this cmdlet accepts, see [Cmdlet Input and Output Types](https://go.microsoft.com/fwlink/p/?LinkId=616387). If the Output Type field is blank, the cmdlet doesn't return data.
130+
131+
## NOTES
132+
133+
## RELATED LINKS

‎exchange/exchange-ps/exchange/Set-ExchangeFeature.md

Lines changed: 140 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,140 @@
1+
---
2+
external help file: Microsoft.Exchange.ServerStatus-Help.xml
3+
online version: https://learn.microsoft.com/powershell/module/exchange/set-exchangefeature
4+
applicable: Exchange Server 2019
5+
title: Set-ExchangeFeature
6+
schema: 2.0.0
7+
author: lusassl-msft
8+
ms.author: lusassl
9+
ms.reviewer: srvar
10+
---
11+
12+
# Set-ExchangeFeature
13+
14+
## SYNOPSIS
15+
This cmdlet is available only in on-premises Exchange.
16+
17+
Use the Set-ExchangeFeature cmdlet to approve or block features flighted via Feature Flighting on Exchange Server.
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+
Set-ExchangeFeature [-Approve]
25+
[-Block]
26+
[-FeatureID <Microsoft.Exchange.Data.MultiValuedProperty`1[System.String]>]
27+
[-Identity] <ServerIdParameter>]
28+
```
29+
30+
## DESCRIPTION
31+
The Set-ExchangeFeature cmdlet lets you approve or block features flighted via Feature Flighting, a service introduced in the Exchange Server 2019 CU15 (2025H1) update.
32+
33+
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).
34+
35+
## EXAMPLES
36+
37+
### Example 1
38+
```powershell
39+
PS C:\> Set-ExchangeFeature -Identity ex01.contoso.com -FeatureID @("F1.1.1") -Approve
40+
```
41+
42+
This command approves the feature F1.1.1 on the computer named ex01.contoso.com.
43+
44+
### Example 2
45+
```powershell
46+
PS C:\> Set-ExchangeFeature -Identity ex01.contoso.com -FeatureID @("F1.1.1", "F1.2.1", "F2.1.1") -Approve
47+
```
48+
49+
This command approves the features F1.1.1, F1.2.1, and F2.1.1 on the computer named ex01.contoso.com.
50+
51+
### Example 3
52+
```powershell
53+
PS C:\> Set-ExchangeFeature -Identity ex01.contoso.com -FeatureID @("F1.1.1", "F1.2.1", "F2.1.1") -Block
54+
```
55+
56+
This command blocks the features F1.1.1, F1.2.1, and F2.1.1 on the computer named ex01.contoso.com.
57+
58+
## PARAMETERS
59+
60+
### -Approve
61+
The Approve parameter approves the feature specified by the FeatureID parameter.
62+
63+
```yaml
64+
Type: SwitchParameter
65+
Parameter Sets: (All)
66+
Aliases:
67+
68+
Required: False
69+
Position: Named
70+
Default value: None
71+
Accept pipeline input: False
72+
Accept wildcard characters: False
73+
```
74+
75+
### -Block
76+
he Block parameter blocks the feature specified by the FeatureID parameter.
77+
78+
```yaml
79+
Type: SwitchParameter
80+
Parameter Sets: (All)
81+
Aliases:
82+
83+
Required: False
84+
Position: Named
85+
Default value: None
86+
Accept pipeline input: False
87+
Accept wildcard characters: False
88+
```
89+
90+
### -FeatureID
91+
The FeatureID parameter specifies the feature you want to control.
92+
93+
```yaml
94+
Type: Microsoft.Exchange.Data.MultiValuedProperty`1[System.String]
95+
Parameter Sets: (All)
96+
Aliases:
97+
98+
Required: False
99+
Position: Named
100+
Default value: None
101+
Accept pipeline input: False
102+
Accept wildcard characters: False
103+
```
104+
105+
### -Identity
106+
The Identity parameter specifies the Exchange server that you want to modify. You can use any value that uniquely identifies the server. For example:
107+
108+
- Name
109+
- FQDN
110+
- Distinguished name (DN)
111+
- Exchange Legacy DN
112+
113+
```yaml
114+
Type: ServerIdParameter
115+
Parameter Sets: (All)
116+
Aliases:
117+
118+
Required: True
119+
Position: 0
120+
Default value: None
121+
Accept pipeline input: True (ByPropertyName, ByValue)
122+
Accept wildcard characters: False
123+
```
124+
125+
### CommonParameters
126+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
127+
128+
## INPUTS
129+
130+
### Input types
131+
To see the input types that this cmdlet accepts, see [Cmdlet Input and Output Types](https://go.microsoft.com/fwlink/p/?LinkId=616387). If the Input Type field for a cmdlet is blank, the cmdlet doesn't accept input data.
132+
133+
## OUTPUTS
134+
135+
### Output types
136+
To see the return types, which are also known as output types, that this cmdlet accepts, see [Cmdlet Input and Output Types](https://go.microsoft.com/fwlink/p/?LinkId=616387). If the Output Type field is blank, the cmdlet doesn't return data.
137+
138+
## NOTES
139+
140+
## RELATED LINKS

‎exchange/exchange-ps/exchange/Set-ExchangeServer.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,7 @@ Set-ExchangeServer [-Identity] <ServerIdParameter>
3434
[-MitigationsEnabled <Boolean>]
3535
[-MonitoringGroup <String>]
3636
[-ProductKey <ProductKey>]
37+
[-RingLevel <String>]
3738
[-StaticConfigDomainController <String>]
3839
[-StaticDomainControllers <MultiValuedProperty>]
3940
[-StaticExcludedDomainControllers <MultiValuedProperty>]
@@ -306,6 +307,21 @@ Accept pipeline input: False
306307
Accept wildcard characters: False
307308
```
308309

310+
### -RingLevel
311+
The RingLevel parameter specifies the server's ring level used by the Feature Flighting feature.
312+
313+
```yaml
314+
Type: String
315+
Parameter Sets: (All)
316+
Aliases:
317+
318+
Required: False
319+
Position: Named
320+
Default value: None
321+
Accept pipeline input: False
322+
Accept wildcard characters: False
323+
```
324+
309325
### -StaticConfigDomainController
310326
The StaticConfigDomainController parameter specifies whether to configure a domain controller to be used by the server via Directory Service Access (DSAccess).
311327

0 commit comments

Comments
 (0)