Skip to content
This repository was archived by the owner on Feb 20, 2022. It is now read-only.

Commit ab6ab59

Browse files
authored
Merge pull request MicrosoftDocs#3080 from MicrosoftDocs/chrisda
Chrisda to Master
2 parents 336e7bc + f305893 commit ab6ab59

File tree

14 files changed

+399
-73
lines changed

14 files changed

+399
-73
lines changed

exchange/exchange-ps/exchange/client-access-servers/New-MapiVirtualDirectory.md

Lines changed: 121 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,19 @@ For information about the parameter sets in the Syntax section below, see Exchan
2121
## SYNTAX
2222

2323
```
24-
New-MapiVirtualDirectory [-Confirm] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-IISAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-Server <ServerIdParameter>] [-WhatIf] [-WebSiteName <String>]
25-
[<CommonParameters>]
24+
New-MapiVirtualDirectory
25+
[-Confirm]
26+
[-DomainController <Fqdn>]
27+
[-ExtendedProtectionFlags <MultiValuedProperty>]
28+
[-ExtendedProtectionSPNList <MultiValuedProperty>]
29+
[-ExtendedProtectionTokenChecking <None | Allow | Require>]
30+
[-ExternalUrl <Uri>]
31+
[-IISAuthenticationMethods <MultiValuedProperty>]
32+
[-InternalUrl <Uri>]
33+
[-Role <ClientAccess | Mailbox>]
34+
[-Server <ServerIdParameter>]
35+
[-WebSiteName <String>]
36+
[-WhatIf] [<CommonParameters>]
2637
```
2738

2839
## DESCRIPTION
@@ -77,6 +88,81 @@ Accept pipeline input: False
7788
Accept wildcard characters: False
7889
```
7990
91+
### -ExtendedProtectionFlags
92+
This parameter is available only in Exchange 2013.
93+
94+
The ExtendedProtectionFlags parameter specifies custom settings for Extended Protection for Authentication on the virtual directory. Valid values are:
95+
96+
- None: This is the default setting.
97+
98+
- AllowDotlessSPN: Required if you want to use Service Principal Name (SPN) values that don't contain FQDNs (for example, HTTP/ContosoMail instead of HTTP/mail.contoso.com). You specify SPNs with the ExtendedProtectionSPNList parameter. This setting makes Extended Protection for Authentication less secure because dotless certificates aren't unique, so it isn't possible to ensure that the client-to-proxy connection was established over a secure channel.
99+
100+
- NoServiceNameCheck: The SPN list isn't checked to validate a channel binding token. This setting makes Extended Protection for Authentication less secure. We generally don't recommend this setting.
101+
102+
- Proxy: A proxy server is responsible for terminating the SSL channel. To use this setting, you need to register an SPN by using the ExtendedProtectionSPNList parameter.
103+
104+
- ProxyCoHosting: HTTP and HTTPS traffic may be accessing the virtual directory, and a proxy server is located between at least some of the clients and the Client Access services on the Exchange server.
105+
106+
```yaml
107+
Type: MultiValuedProperty
108+
Parameter Sets: (All)
109+
Aliases:
110+
Applicable: Exchange Server 2013
111+
Required: False
112+
Position: Named
113+
Default value: None
114+
Accept pipeline input: False
115+
Accept wildcard characters: False
116+
```
117+
118+
### -ExtendedProtectionSPNList
119+
This parameter is available only in Exchange 2013.
120+
121+
The ExtendedProtectionSPNList parameter specifies a list of valid Service Principal Names (SPNs) if you're using Extended Protection for Authentication on the virtual directory. Valid values are:
122+
123+
- $null: This is the default value.
124+
125+
- Single SPN or comma delimited list of valid SPNs: The SPN value format is \<protocol\>/\<FQDN\>. For example, HTTP/mail.contoso.com. To add an SPN that's not an FQDN (for example, HTTP/ContosoMail), you also need to use the AllowDotlessSPN value for the ExtendedProtectionFlags parameter.
126+
127+
```yaml
128+
Type: MultiValuedProperty
129+
Parameter Sets: (All)
130+
Aliases:
131+
Applicable: Exchange Server 2013
132+
Required: False
133+
Position: Named
134+
Default value: None
135+
Accept pipeline input: False
136+
Accept wildcard characters: False
137+
```
138+
139+
### -ExtendedProtectionTokenChecking
140+
This parameter is available only in Exchange 2013.
141+
142+
The ExtendedProtectionTokenChecking parameter defines how you want to use Extended Protection for Authentication on the virtual directory. Extended Protection for Authentication isn't enabled by default. Valid values are:
143+
144+
- None: Extended Protection for Authentication isn't be used on the virtual directory. This is the default value.
145+
146+
- Allow: Extended Protection for Authentication is used for connections between clients and the virtual directory if both the client and server support it. Connections that don't support Extended Protection for Authentication will work, but may not be as secure as connections that use Extended Protection for Authentication.
147+
148+
- Require: Extended Protection for Authentication is used for all connections between clients and the virtual directory. If either the client or server doesn't support it, the connection will fail. If you use this value, you also need to set an SPN value for the ExtendedProtectionSPNList parameter.
149+
150+
Note:
151+
152+
If you use the value Allow or Require, and you have a proxy server between the client and the Client Access services on the Mailbox server that's configured to terminate the client-to-proxy SSL channel, you also need to configure one or more Service Principal Names (SPNs) by using the ExtendedProtectionSPNList parameter.
153+
154+
```yaml
155+
Type: None | Allow | Require
156+
Parameter Sets: (All)
157+
Aliases:
158+
Applicable: Exchange Server 2013
159+
Required: False
160+
Position: Named
161+
Default value: None
162+
Accept pipeline input: False
163+
Accept wildcard characters: False
164+
```
165+
80166
### -ExternalUrl
81167
The ExternalURL parameter specifies the URL that's used to connect to the virtual directory from outside the firewall.
82168
@@ -142,6 +228,29 @@ Accept pipeline input: False
142228
Accept wildcard characters: False
143229
```
144230
231+
### -Role
232+
This parameter is available only in Exchange 2013.
233+
234+
The Role parameter species the configuration for the virtual directory. Valid values are:
235+
236+
- ClientAccess: Configure the virtual directory for the Client Access (frontend) services on the Mailbox server.
237+
238+
- Mailbox: Configure the virtual directory for the backend services on the Mailbox server.
239+
240+
Client connections are proxied from the Client Access services to the backend services on local or remote Mailbox servers. Clients don't connect directly to the backend services.
241+
242+
```yaml
243+
Type: ClientAccess | Mailbox
244+
Parameter Sets: (All)
245+
Aliases:
246+
Applicable: Exchange Server 2013
247+
Required: False
248+
Position: Named
249+
Default value: None
250+
Accept pipeline input: False
251+
Accept wildcard characters: False
252+
```
253+
145254
### -Server
146255
The Server parameter specifies the Exchange server that hosts the virtual directory. You can use any value that uniquely identifies the server. For example:
147256
@@ -165,29 +274,29 @@ Accept pipeline input: True
165274
Accept wildcard characters: False
166275
```
167276
168-
### -WhatIf
169-
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.
277+
### -WebSiteName
278+
The WebSiteName parameter specifies the name of the IIS website under which the virtual directory is created. You don't need to use this parameter to create the virtual directory under the default website.
170279
171280
```yaml
172-
Type: SwitchParameter
281+
Type: String
173282
Parameter Sets: (All)
174-
Aliases: wi
175-
Applicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
283+
Aliases:
284+
Applicable: Exchange Server 2016, Exchange Server 2019
176285
Required: False
177286
Position: Named
178287
Default value: None
179288
Accept pipeline input: False
180289
Accept wildcard characters: False
181290
```
182291
183-
### -WebSiteName
184-
The WebSiteName parameter specifies the name of the IIS website under which the virtual directory is created. You don't need to use this parameter to create the virtual directory under the default website.
292+
### -WhatIf
293+
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.
185294
186295
```yaml
187-
Type: String
296+
Type: SwitchParameter
188297
Parameter Sets: (All)
189-
Aliases:
190-
Applicable: Exchange Server 2016, Exchange Server 2019
298+
Aliases: wi
299+
Applicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
191300
Required: False
192301
Position: Named
193302
Default value: None

exchange/exchange-ps/exchange/client-access-servers/Set-MapiVirtualDirectory.md

Lines changed: 86 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,17 @@ For information about the parameter sets in the Syntax section below, see Exchan
2121
## SYNTAX
2222

2323
```
24-
Set-MapiVirtualDirectory [-Identity] <VirtualDirectoryIdParameter> [-ApplyDefaults <$true | $false>] [-Confirm]
25-
[-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-IISAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-WhatIf]
26-
[<CommonParameters>]
24+
Set-MapiVirtualDirectory [-Identity] <VirtualDirectoryIdParameter>
25+
[-ApplyDefaults <$true | $false>]
26+
[-Confirm]
27+
[-DomainController <Fqdn>]
28+
[-ExtendedProtectionFlags <MultiValuedProperty>]
29+
[-ExtendedProtectionSPNList <MultiValuedProperty>]
30+
[-ExtendedProtectionTokenChecking <None | Allow | Require>]
31+
[-ExternalUrl <Uri>]
32+
[-IISAuthenticationMethods <MultiValuedProperty>]
33+
[-InternalUrl <Uri>]
34+
[-WhatIf] [<CommonParameters>]
2735
```
2836

2937
## DESCRIPTION
@@ -120,6 +128,81 @@ Accept pipeline input: False
120128
Accept wildcard characters: False
121129
```
122130
131+
### -ExtendedProtectionFlags
132+
This parameter is available only in Exchange 2013.
133+
134+
The ExtendedProtectionFlags parameter specifies custom settings for Extended Protection for Authentication on the virtual directory. Valid values are:
135+
136+
- None: This is the default setting.
137+
138+
- AllowDotlessSPN: Required if you want to use Service Principal Name (SPN) values that don't contain FQDNs (for example, HTTP/ContosoMail instead of HTTP/mail.contoso.com). You specify SPNs with the ExtendedProtectionSPNList parameter. This setting makes Extended Protection for Authentication less secure because dotless certificates aren't unique, so it isn't possible to ensure that the client-to-proxy connection was established over a secure channel.
139+
140+
- NoServiceNameCheck: The SPN list isn't checked to validate a channel binding token. This setting makes Extended Protection for Authentication less secure. We generally don't recommend this setting.
141+
142+
- Proxy: A proxy server is responsible for terminating the SSL channel. To use this setting, you need to register an SPN by using the ExtendedProtectionSPNList parameter.
143+
144+
- ProxyCoHosting: HTTP and HTTPS traffic may be accessing the virtual directory, and a proxy server is located between at least some of the clients and the Client Access services on the Exchange server.
145+
146+
```yaml
147+
Type: MultiValuedProperty
148+
Parameter Sets: (All)
149+
Aliases:
150+
Applicable: Exchange Server 2013
151+
Required: False
152+
Position: Named
153+
Default value: None
154+
Accept pipeline input: False
155+
Accept wildcard characters: False
156+
```
157+
158+
### -ExtendedProtectionSPNList
159+
This parameter is available only in Exchange 2013.
160+
161+
The ExtendedProtectionSPNList parameter specifies a list of valid Service Principal Names (SPNs) if you're using Extended Protection for Authentication on the virtual directory. Valid values are:
162+
163+
- $null: This is the default value.
164+
165+
- Single SPN or comma delimited list of valid SPNs: The SPN value format is \<protocol\>/\<FQDN\>. For example, HTTP/mail.contoso.com. To add an SPN that's not an FQDN (for example, HTTP/ContosoMail), you also need to use the AllowDotlessSPN value for the ExtendedProtectionFlags parameter.
166+
167+
```yaml
168+
Type: MultiValuedProperty
169+
Parameter Sets: (All)
170+
Aliases:
171+
Applicable: Exchange Server 2013
172+
Required: False
173+
Position: Named
174+
Default value: None
175+
Accept pipeline input: False
176+
Accept wildcard characters: False
177+
```
178+
179+
### -ExtendedProtectionTokenChecking
180+
This parameter is available only in Exchange 2013.
181+
182+
The ExtendedProtectionTokenChecking parameter defines how you want to use Extended Protection for Authentication on the virtual directory. Extended Protection for Authentication isn't enabled by default. Valid values are:
183+
184+
- None: Extended Protection for Authentication isn't be used on the virtual directory. This is the default value.
185+
186+
- Allow: Extended Protection for Authentication is used for connections between clients and the virtual directory if both the client and server support it. Connections that don't support Extended Protection for Authentication will work, but may not be as secure as connections that use Extended Protection for Authentication.
187+
188+
- Require: Extended Protection for Authentication is used for all connections between clients and the virtual directory. If either the client or server doesn't support it, the connection will fail. If you use this value, you also need to set an SPN value for the ExtendedProtectionSPNList parameter.
189+
190+
Note:
191+
192+
If you use the value Allow or Require, and you have a proxy server between the client and the Client Access services on the Mailbox server that's configured to terminate the client-to-proxy SSL channel, you also need to configure one or more Service Principal Names (SPNs) by using the ExtendedProtectionSPNList parameter.
193+
194+
```yaml
195+
Type: None | Allow | Require
196+
Parameter Sets: (All)
197+
Aliases:
198+
Applicable: Exchange Server 2013
199+
Required: False
200+
Position: Named
201+
Default value: None
202+
Accept pipeline input: False
203+
Accept wildcard characters: False
204+
```
205+
123206
### -ExternalUrl
124207
The ExternalURL parameter specifies the URL that's used to connect to the virtual directory from outside the firewall.
125208

exchange/exchange-ps/exchange/client-access/Test-OutlookConnectivity.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -89,9 +89,10 @@ Running the Test-OutlookConnectivity cmdlet validates an Outlook connection defi
8989

9090
The Test-OutlookConnectivity cmdlet runs the same process as the monitoring probes. The Microsoft Exchange Health Manager (MSExchangeHM) service must be running and have created the Outlook probes on the machine that will be tested. You need to select one of the Outlook probe identities to run the test. Use the Get-MonitoringItemIdentity (https://go.microsoft.com/fwlink/p/?LinkId=510841) cmdlet to see what probes are active.
9191

92-
This example lists the probes running in the backend services on a Mailbox server.
92+
This example lists the probes running in the backend services on a Mailbox server: `Get-MonitoringItemIdentity -Server MailboxServer1 -Identity outlook.protocol | ?{$_.Name -like '*probe'}`.
9393

94-
This example lists the probes running in the client access services on a Mailbox server.
94+
95+
This example lists the probes running in the client access services on a Mailbox server: `Get-MonitoringItemIdentity -Server MailboxServer1 -Identity outlook | ?{$_.Name -like '*probe'}`.
9596

9697
For more information on probes and the monitoring framework, see Managed Availability (https://go.microsoft.com/fwlink/p/?LinkId=510838), Managed Availability and Server Health (https://go.microsoft.com/fwlink/p/?LinkId=510839), and Customizing Managed Availability (https://go.microsoft.com/fwlink/p/?LinkId=510840)
9798

exchange/exchange-ps/exchange/devices/Set-ActiveSyncOrganizationSettings.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,15 @@ Accept wildcard characters: False
111111
```
112112
113113
### -DefaultAccessLevel
114-
The DefaultAccessLevel parameter specifies the access level for new devices. Valid values are Allow,Block or Quarantine. The default value is Allow.
114+
The DefaultAccessLevel parameter specifies the access level for new and existing device partnerships. Valid values are:
115+
116+
- Allow (This is the default value)
117+
118+
- Block
119+
120+
- Quarantine
121+
122+
If you change this value from Allow to Block or Quarantine, all existing connected devices are immediately affected, unless the devices are subject to device access rules or individual allow or block list entries.
115123
116124
```yaml
117125
Type: Allow | Block | Quarantine

exchange/exchange-ps/exchange/email-addresses-and-address-books/Get-EmailAddressPolicy.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,10 @@ For information about the parameter sets in the Syntax section below, see Exchan
2121
## SYNTAX
2222

2323
```
24-
Get-EmailAddressPolicy [[-Identity] <EmailAddressPolicyIdParameter>] [-DomainController <Fqdn>]
25-
[-IncludeMailboxSettingOnlyPolicy] [<CommonParameters>]
24+
Get-EmailAddressPolicy [[-Identity] <EmailAddressPolicyIdParameter>]
25+
[-DomainController <Fqdn>]
26+
[-IncludeMailboxSettingOnlyPolicy]
27+
[<CommonParameters>]
2628
```
2729

2830
## DESCRIPTION
@@ -87,9 +89,9 @@ Accept wildcard characters: False
8789
### -IncludeMailboxSettingOnlyPolicy
8890
This parameter is available or functional only in Exchange Server 2010.
8991
90-
The IncludeMailboxSettingOnlyPolicy parameter retrieves Microsoft Exchange Server 2003 address policies that contain only mailbox management configuration. Microsoft Exchange Server 2010 supports both policies that contain only address policy settings and policies that contain address policy settings and mailbox management configuration. Exchange 2010 doesn't support policies that contain only mailbox management configuration, but Exchange 2003 policies that contain only mailbox management configuration are, by default, preserved and not upgraded. The IncludeMailboxSettingOnlyPolicy parameter is required to retrieve these policies.
92+
The IncludeMailboxSettingOnlyPolicy parameter retrieves Microsoft Exchange Server 2003 address policies that contain only mailbox management configuration. Microsoft Exchange Server 2010 supports both policies that contain only address policy settings and policies that contain address policy settings and mailbox management configuration. Exchange 2010 doesn't support policies that contain only mailbox management configuration, but Exchange 2003 policies that contain only mailbox management configuration are, by default, preserved and not upgraded. The IncludeMailboxSettingOnlyPolicy parameter is required to retrieve these policies.
9193
92-
The attributes of address policies that contain only mailbox management configuration can't be modified in Exchange 2010. These policies can only be removed.
94+
The attributes of address policies that contain only mailbox management configuration can't be modified in Exchange 2010. These policies can only be removed.
9395
9496
```yaml
9597
Type: SwitchParameter

exchange/exchange-ps/exchange/mailboxes/New-MailboxExportRequest.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -723,7 +723,7 @@ The Priority parameter specifies the order in which the request should be proces
723723
Type: Normal | High
724724
Parameter Sets: (All)
725725
Aliases:
726-
Applicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
726+
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
727727
Required: False
728728
Position: Named
729729
Default value: None
@@ -791,7 +791,7 @@ The SourceRootFolder parameter specifies the root folder of the mailbox from whi
791791
Type: String
792792
Parameter Sets: Mailbox, MailboxExportRequest
793793
Aliases:
794-
Applicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
794+
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
795795
Required: False
796796
Position: Named
797797
Default value: None
@@ -806,7 +806,7 @@ The Suspend switch specifies whether to suspend the request. If you use this swi
806806
Type: SwitchParameter
807807
Parameter Sets: (All)
808808
Aliases:
809-
Applicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
809+
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
810810
Required: False
811811
Position: Named
812812
Default value: None
@@ -821,7 +821,7 @@ The SuspendComment parameter specifies a description about why the request was s
821821
Type: String
822822
Parameter Sets: (All)
823823
Aliases:
824-
Applicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
824+
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
825825
Required: False
826826
Position: Named
827827
Default value: None
@@ -836,7 +836,7 @@ The TargetRootFolder parameter specifies the top-level folder in which to export
836836
Type: String
837837
Parameter Sets: Mailbox, MailboxExportRequest
838838
Aliases:
839-
Applicable: Exchange Server 2016, Exchange Server 2019
839+
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
840840
Required: True
841841
Position: Named
842842
Default value: None
@@ -866,7 +866,7 @@ The WorkloadType parameter is reserved for internal Microsoft use.
866866
Type: None | Local | Onboarding | Offboarding | TenantUpgrade | LoadBalancing | Emergency | RemotePstIngestion | SyncAggregation | RemotePstExport
867867
Parameter Sets: (All)
868868
Aliases:
869-
Applicable: Exchange Server 2016, Exchange Server 2019
869+
Applicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
870870
Required: False
871871
Position: Named
872872
Default value: None

0 commit comments

Comments
 (0)