Skip to content

Commit 0acb656

Browse files
authored
Merge pull request MicrosoftDocs#154 from nsshommo/nasim
Cleanup & Consolidate
2 parents 04f33a0 + d632453 commit 0acb656

File tree

5 files changed

+30
-554
lines changed

5 files changed

+30
-554
lines changed

exchange/exchange-ps/exchange/Get-MapiVirtualDirectory.md

Lines changed: 6 additions & 92 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,6 @@ schema: 2.0.0
66
# Get-MapiVirtualDirectory
77

88
## SYNOPSIS
9-
!!! Exchange Server 2013
10-
11-
This cmdlet is available only in on-premises Exchange.
12-
13-
Use the Get-MapiVirtualDirectory cmdlet to view Message 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-
For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax (https://technet.microsoft.com/library/bb123552.aspx).
16-
17-
!!! Exchange Server 2016
18-
199
This cmdlet is available only in on-premises Exchange.
2010

2111
Use the Get-MapiVirtualDirectory cmdlet to view Message 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.
@@ -26,56 +16,35 @@ For information about the parameter sets in the Syntax section below, see Exchan
2616

2717
### Set2
2818
```
29-
Get-MapiVirtualDirectory -Server <ServerIdParameter> [-ADPropertiesOnly] [-DomainController <Fqdn>]
30-
[-ShowMailboxVirtualDirectories] [<CommonParameters>]
19+
Get-MapiVirtualDirectory -Server <ServerIdParameter> [-ADPropertiesOnly] [-DomainController <Fqdn>] [<CommonParameters>]
3120
```
3221

3322
### Set1
3423
```
3524
Get-MapiVirtualDirectory [[-Identity] <VirtualDirectoryIdParameter>] [-ADPropertiesOnly]
36-
[-DomainController <Fqdn>] [-ShowMailboxVirtualDirectories] [<CommonParameters>]
25+
[-DomainController <Fqdn>] [<CommonParameters>]
3726
```
3827

3928
## DESCRIPTION
40-
!!! Exchange Server 2013
41-
42-
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.
43-
44-
!!! Exchange Server 2016
45-
4629
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).
4730

4831
## EXAMPLES
4932

50-
### Example 1 -------------------------- (Exchange Server 2013)
51-
```
52-
Get-MapiVirtualDirectory -Server ContosoMail
53-
```
54-
55-
This example returns the settings of the MAPI virtual directory on the server named ContosoMail.
56-
57-
### Example 1 -------------------------- (Exchange Server 2016)
33+
### Example 1
5834
```
5935
Get-MapiVirtualDirectory -Server ContosoMail
6036
```
6137

6238
This example returns a summary list of the MAPI virtual directories on the server named ContosoMail.
6339

64-
### Example 2 -------------------------- (Exchange Server 2013)
65-
```
66-
Get-MapiVirtualDirectory -Identity "ContosoMail\mapi (Default Web Site)"; Get-MapiVirtualDirectory "mapi (Default Web Site)"; Get-MapiVirtualDirectory mapi*
67-
```
68-
69-
These examples return the settings of the MAPI virtual directory on the local server named ContosoMail. All three commands do the same thing.
70-
71-
### Example 2 -------------------------- (Exchange Server 2016)
40+
### Example 2
7241
```
7342
Get-MapiVirtualDirectory -Identity "ContosoMail\mapi (Default Web Site)" | Format-List; Get-MapiVirtualDirectory "ContosoMail\mapi (Default Web Site)" | Format-List; Get-MapiVirtualDirectory ContosoMai\mapi* | Format-List
7443
```
7544

7645
These examples return detailed information for the MAPI virtual directory named "mapi (Default Web Site)" on the server named ContosoMail. All three commands do the same thing.
7746

78-
### Example 3 -------------------------- (Exchange Server 2016)
47+
### Example 3
7948
```
8049
Get-MapiVirtualDirectory
8150
```
@@ -85,24 +54,6 @@ This example returns a summary list of all MAPI virtual directories in the clien
8554
## PARAMETERS
8655

8756
### -Server
88-
!!! Exchange Server 2013
89-
90-
The Server parameter specifies the Exchange server that will host the virtual directory. You can use any value that uniquely identifies the server. For example:
91-
92-
- Name
93-
94-
- FQDN
95-
96-
- Distinguished name (DN)
97-
98-
- Exchange Legacy DN
99-
100-
If you don't use the Server parameter, the virtual directory will be created on the server where the remote PowerShell session is established. This will always be a Mailbox server. If you want to create the virtual directory on a Client Access server or another Mailbox server, you need to use the Server parameter.
101-
102-
103-
104-
!!! Exchange Server 2016
105-
10657
The Server parameter specifies the Exchange server that hosts the virtual directory. You can use any value that uniquely identifies the server. For example:
10758

10859
- Name
@@ -116,7 +67,6 @@ The Server parameter specifies the Exchange server that hosts the virtual direct
11667
You can't use the Server and Identity parameters in the same command.
11768

11869

119-
12070
```yaml
12171
Type: ServerIdParameter
12272
Parameter Sets: Set2
@@ -163,24 +113,6 @@ Accept wildcard characters: False
163113
```
164114
165115
### -Identity
166-
!!! Exchange Server 2013
167-
168-
The Identity parameter specifies the MAPI virtual directory that you want to view.
169-
170-
You can use any value that uniquely identifies the virtual directory. For example:
171-
172-
- Name or \<Server\>\\Name
173-
174-
- Distinguished name (DN)
175-
176-
- GUID
177-
178-
The Name value uses the syntax "\<VirtualDirectoryName\> (\<WebsiteName\>)" from the properties of the virtual directory. You can specify the wildcard character (\*) instead of the default website by using the syntax \<VirtualDirectoryName\>\*.
179-
180-
181-
182-
!!! Exchange Server 2016
183-
184116
The Identity parameter specifies the MAPI virtual directory that you want to view.
185117
186118
You can use any value that uniquely identifies the virtual directory. For example:
@@ -196,7 +128,6 @@ The Name value uses the syntax "\<VirtualDirectoryName\> (\<WebsiteName\>)" from
196128
You can't use the Identity and Server parameters in the same command.
197129
198130
199-
200131
```yaml
201132
Type: VirtualDirectoryIdParameter
202133
Parameter Sets: Set1
@@ -210,24 +141,8 @@ Accept pipeline input: True
210141
Accept wildcard characters: False
211142
```
212143
213-
### -ShowMailboxVirtualDirectories
214-
This parameter is reserved for internal Microsoft use.
215-
216-
```yaml
217-
Type: SwitchParameter
218-
Parameter Sets: (All)
219-
Aliases:
220-
Applicable: Exchange Server 2013
221-
222-
Required: False
223-
Position: Named
224-
Default value: None
225-
Accept pipeline input: False
226-
Accept wildcard characters: False
227-
```
228-
229144
### CommonParameters
230-
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).
145+
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).
231146
232147
## INPUTS
233148
@@ -244,4 +159,3 @@ To see the return types, which are also known as output types, that this cmdlet
244159
## RELATED LINKS
245160
246161
[Online Version](https://technet.microsoft.com/library/6837cb55-6734-4a28-9062-7227f57dafb2.aspx)
247-

exchange/exchange-ps/exchange/New-MapiVirtualDirectory.md

Lines changed: 5 additions & 138 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,6 @@ schema: 2.0.0
66
# New-MapiVirtualDirectory
77

88
## SYNOPSIS
9-
!!! Exchange Server 2013
10-
11-
This cmdlet is available only in on-premises Exchange.
12-
13-
Use the New-MapiVirtualDirectory cmdlet to create Messaging Application Programming Interface (MAPI) virtual directories on Microsoft Exchange 2013 servers A MAPI virtual directory is used by supported versions of Microsoft Outlook to connect to mailboxes by using the MAPIHTTP protocol.
14-
15-
For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax (https://technet.microsoft.com/library/bb123552.aspx).
16-
17-
!!! Exchange Server 2016
18-
199
This cmdlet is available only in on-premises Exchange.
2010

2111
Use the New-MapiVirtualDirectory cmdlet to create 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.
@@ -25,47 +15,25 @@ For information about the parameter sets in the Syntax section below, see Exchan
2515
## SYNTAX
2616

2717
```
28-
New-MapiVirtualDirectory [-Confirm] [-DomainController <Fqdn>] [-ExtendedProtectionFlags <MultiValuedProperty>]
29-
[-ExtendedProtectionSPNList <MultiValuedProperty>] [-ExtendedProtectionTokenChecking <None | Allow | Require>]
30-
[-ExternalUrl <Uri>] [-IISAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>]
31-
[-Role <ClientAccess | Mailbox>] [-Server <ServerIdParameter>] [-WhatIf] [-WebSiteName <String>]
18+
New-MapiVirtualDirectory [-Confirm] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-IISAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-Server <ServerIdParameter>] [-WhatIf] [-WebSiteName <String>]
3219
[<CommonParameters>]
3320
```
3421

3522
## DESCRIPTION
36-
!!! Exchange Server 2013
37-
38-
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.
39-
40-
!!! Exchange Server 2016
41-
4223
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).
4324

4425
## EXAMPLES
4526

46-
### Example 1 -------------------------- (Exchange Server 2013)
47-
```
48-
New-MapiVirtualDirectory -InternalUrl https://contoso.com/mapi -IISAuthenticationMethods NTLM,Negotiate
49-
```
50-
51-
This example creates a new MAPI virtual directory that has the following configuration:
52-
53-
54-
Internal URL https://contoso.com/mapi
55-
56-
IIS authentication methods NTLM and Negotiate.
57-
58-
### Example 1 -------------------------- (Exchange Server 2016)
27+
### Example 1
5928
```
6029
New-MapiVirtualDirectory -InternalUrl https://contoso.com/mapi -IISAuthenticationMethods NTLM,Negotiate,OAuth
6130
```
6231

6332
This example creates a new MAPI virtual directory that has the following configuration:
6433

34+
- Internal URL: https://contoso.com/mapi
6535

66-
Internal URL: https://contoso.com/mapi
67-
68-
IIS authentication methods: NTLM, Negotiate, and OAuth.
36+
- IIS authentication methods: NTLM, Negotiate and OAuth.
6937

7038
## PARAMETERS
7139

@@ -105,54 +73,6 @@ Accept pipeline input: False
10573
Accept wildcard characters: False
10674
```
10775
108-
### -ExtendedProtectionFlags
109-
This parameter is reserved for internal Microsoft use.
110-
111-
```yaml
112-
Type: MultiValuedProperty
113-
Parameter Sets: (All)
114-
Aliases:
115-
Applicable: Exchange Server 2013
116-
117-
Required: False
118-
Position: Named
119-
Default value: None
120-
Accept pipeline input: False
121-
Accept wildcard characters: False
122-
```
123-
124-
### -ExtendedProtectionSPNList
125-
This parameter is reserved for internal Microsoft use.
126-
127-
```yaml
128-
Type: MultiValuedProperty
129-
Parameter Sets: (All)
130-
Aliases:
131-
Applicable: Exchange Server 2013
132-
133-
Required: False
134-
Position: Named
135-
Default value: None
136-
Accept pipeline input: False
137-
Accept wildcard characters: False
138-
```
139-
140-
### -ExtendedProtectionTokenChecking
141-
This parameter is reserved for internal Microsoft use.
142-
143-
```yaml
144-
Type: None | Allow | Require
145-
Parameter Sets: (All)
146-
Aliases:
147-
Applicable: Exchange Server 2013
148-
149-
Required: False
150-
Position: Named
151-
Default value: None
152-
Accept pipeline input: False
153-
Accept wildcard characters: False
154-
```
155-
15676
### -ExternalUrl
15777
The ExternalURL parameter specifies the URL that's used to connect to the virtual directory from outside the firewall.
15878
@@ -174,22 +94,6 @@ Accept wildcard characters: False
17494
```
17595
17696
### -IISAuthenticationMethods
177-
!!! Exchange Server 2013
178-
179-
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:
180-
181-
- Basic
182-
183-
- Negotiate
184-
185-
- NTLM
186-
187-
You can specify multiple values separated by commas.
188-
189-
190-
191-
!!! Exchange Server 2016
192-
19397
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:
19498
19599
- Basic
@@ -205,7 +109,6 @@ You can specify multiple values separated by commas.
205109
The default values are NTLM, OAuth, and Negotiate. We recommend that you always have the virtual directory configured for OAuth.
206110
207111
208-
209112
```yaml
210113
Type: MultiValuedProperty
211114
Parameter Sets: (All)
@@ -239,41 +142,7 @@ Accept pipeline input: False
239142
Accept wildcard characters: False
240143
```
241144
242-
### -Role
243-
This parameter is reserved for internal Microsoft use.
244-
245-
```yaml
246-
Type: ClientAccess | Mailbox
247-
Parameter Sets: (All)
248-
Aliases:
249-
Applicable: Exchange Server 2013
250-
251-
Required: False
252-
Position: Named
253-
Default value: None
254-
Accept pipeline input: False
255-
Accept wildcard characters: False
256-
```
257-
258145
### -Server
259-
!!! Exchange Server 2013
260-
261-
The Server parameter specifies the Exchange server that will host the virtual directory. You can use any value that uniquely identifies the server. For example:
262-
263-
- Name
264-
265-
- FQDN
266-
267-
- Distinguished name (DN)
268-
269-
- Exchange Legacy DN
270-
271-
If you don't use the Server parameter, the virtual directory will be created on the server where the remote PowerShell session is established. This will always be a Mailbox server. If you want to create the virtual directory on a Client Access server or another Mailbox server, you need to use the Server parameter.
272-
273-
274-
275-
!!! Exchange Server 2016
276-
277146
The Server parameter specifies the Exchange server that hosts the virtual directory. You can use any value that uniquely identifies the server. For example:
278147
279148
- Name
@@ -285,7 +154,6 @@ The Server parameter specifies the Exchange server that hosts the virtual direct
285154
- ExchangeLegacyDN
286155
287156
288-
289157
```yaml
290158
Type: ServerIdParameter
291159
Parameter Sets: (All)
@@ -332,7 +200,7 @@ Accept wildcard characters: False
332200
```
333201
334202
### CommonParameters
335-
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).
203+
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).
336204
337205
## INPUTS
338206
@@ -349,4 +217,3 @@ To see the return types, which are also known as output types, that this cmdlet
349217
## RELATED LINKS
350218
351219
[Online Version](https://technet.microsoft.com/library/acb5be3d-f42b-4685-ba2a-680731281edf.aspx)
352-

0 commit comments

Comments
 (0)