You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: exchange/exchange-ps/exchange/Set-MapiVirtualDirectory.md
+6-104Lines changed: 6 additions & 104 deletions
Original file line number
Diff line number
Diff line change
@@ -6,14 +6,6 @@ schema: 2.0.0
6
6
# Set-MapiVirtualDirectory
7
7
8
8
## SYNOPSIS
9
-
!!! Exchange Server 2013
10
-
11
-
This cmdlet is available only in on-premises Exchange.
12
-
13
-
Use the Set-MapiVirtualDirectory cmdlet to modify Messaging Application Programming Interface (MAPI) virtual directories on MicrosoftExchange 2013 servers. A MAPI virtual directory is used by supported versions of MicrosoftOutlook to connect to mailboxes by using the MAPIHTTP protocol.
14
-
15
-
!!! Exchange Server 2016
16
-
17
9
This cmdlet is available only in on-premises Exchange.
18
10
19
11
Use the Set-MapiVirtualDirectory cmdlet to modify Messaging Application Programming Interface (MAPI) virtual directories that are used in Internet Information Services (IIS) on Microsoft Exchange servers. A MAPI virtual directory is used by supported versions of Microsoft Outlook to connect to mailboxes by using the MAPIHTTP protocol.
@@ -22,46 +14,25 @@ Use the Set-MapiVirtualDirectory cmdlet to modify Messaging Application Programm
You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Client Access virtual directory settings" entry in the Clients and mobile devices permissions topic.
35
-
36
-
!!! Exchange Server 2016
37
-
38
22
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://technet.microsoft.com/library/mt432940.aspx).
39
23
40
24
## EXAMPLES
41
25
42
-
### Example 1 -------------------------- (Exchange Server 2013)
43
-
```
44
-
Set-MapiVirtualDirectory -Identity "ContosoMail\mapi (Default Web Site)" -InternalUrl https://contoso.com/mapi -IISAuthenticationMethods NTLM,Negotiate
45
-
```
46
-
47
-
This example makes the following configuration changes to the MAPI virtual directory on the default web site of the server named ContosoMail:
48
-
49
-
50
-
Internal URL https://contoso/mapi.
51
-
52
-
IIS authentication methods NTLM and Negotiate.
53
-
54
-
### Example 1 -------------------------- (Exchange Server 2016)
26
+
### Example 1
55
27
```
56
28
Set-MapiVirtualDirectory -Identity "ContosoMail\mapi (Default Web Site)" -InternalUrl https://contoso.com/mapi -IISAuthenticationMethods NTLM,Negotiate,OAuth
57
29
```
58
30
59
31
This example makes the following configuration changes to the MAPI virtual directory on the default web site of the server named ContosoMail:
60
32
33
+
- Internal URL: https://contoso/mapi.
61
34
62
-
Internal URL: https://contoso/mapi.
63
-
64
-
IIS authentication methods: NTLM, Negotiate, and OAuth.
35
+
- IIS authentication methods: NTLM, Negotiate, and OAuth.
The ApplyDefaults switch specifies whether to apply the correct defaults to the related internal IIS application settings. Typically, this switch is used only by Exchange setup during the installation of Exchange Cumulative Updates or Service Packs, and you shouldn't need to use it.
66
+
The ApplyDefaults switch specifies whether to apply the correct defaults to the related internal IIS application settings. Typically, this switch is used only by Exchange setup during the installation of Exchange Cumulative Updates or Service Packs and you shouldn't need to use it.
96
67
97
68
This switch doesn't affect the values you configure by using the IISAuthenticationMethods, InternalUrl or ExternalUrl parameters.
98
69
@@ -145,54 +116,6 @@ Accept pipeline input: False
145
116
Accept wildcard characters: False
146
117
```
147
118
148
-
### -ExtendedProtectionFlags
149
-
This parameter is reserved for internal Microsoft use.
150
-
151
-
```yaml
152
-
Type: MultiValuedProperty
153
-
Parameter Sets: (All)
154
-
Aliases:
155
-
Applicable: Exchange Server 2013
156
-
157
-
Required: False
158
-
Position: Named
159
-
Default value: None
160
-
Accept pipeline input: False
161
-
Accept wildcard characters: False
162
-
```
163
-
164
-
### -ExtendedProtectionSPNList
165
-
This parameter is reserved for internal Microsoft use.
166
-
167
-
```yaml
168
-
Type: MultiValuedProperty
169
-
Parameter Sets: (All)
170
-
Aliases:
171
-
Applicable: Exchange Server 2013
172
-
173
-
Required: False
174
-
Position: Named
175
-
Default value: None
176
-
Accept pipeline input: False
177
-
Accept wildcard characters: False
178
-
```
179
-
180
-
### -ExtendedProtectionTokenChecking
181
-
This parameter is reserved for internal Microsoft use.
182
-
183
-
```yaml
184
-
Type: None | Allow | Require
185
-
Parameter Sets: (All)
186
-
Aliases:
187
-
Applicable: Exchange Server 2013
188
-
189
-
Required: False
190
-
Position: Named
191
-
Default value: None
192
-
Accept pipeline input: False
193
-
Accept wildcard characters: False
194
-
```
195
-
196
119
### -ExternalUrl
197
120
The ExternalURL parameter specifies the URL that's used to connect to the virtual directory from outside the firewall.
The IISAuthenticationMethods parameter specifies the authentication methods that are enabled on the virtual directory in Internet Information Services (IIS). Valid values for this parameter are:
220
-
221
-
- Basic
222
-
223
-
- Negotiate
224
-
225
-
- NTLM
226
-
227
-
To enter multiple values and overwrite any existing entries, use the following syntax: \<value1\>,\<value2\>.... If the values contain spaces or otherwise require quotation marks, you need to use the following syntax: "\<value1\>","\<value2\>"....
228
-
229
-
To add or remove one or more values without affecting any existing entries, use the following syntax: @{Add="\<value1\>","\<value2\>"...; Remove="\<value1\>","\<value2\>"...}.
230
-
231
-
232
-
233
-
!!! Exchange Server 2016
234
-
235
140
The IISAuthenticationMethods parameter specifies the authentication methods that are enabled on the virtual directory in Internet Information Services (IIS). Valid values are:
236
141
237
142
- Basic
@@ -246,8 +151,6 @@ You can specify multiple values separated by commas.
246
151
247
152
The default values are NTLM, OAuth, and Negotiate. We recommend that you always have the virtual directory configured for OAuth.
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
204
+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction and -WarningVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
302
205
303
206
## INPUTS
304
207
@@ -315,4 +218,3 @@ To see the return types, which are also known as output types, that this cmdlet
0 commit comments