Skip to content

Commit d8f3c2d

Browse files
committed
Merge branch 'master' into Feedback-chrisda
2 parents 9e4b6ce + 9a0447d commit d8f3c2d

File tree

258 files changed

+6554
-1505
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

258 files changed

+6554
-1505
lines changed

exchange/docfx.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,10 @@
8181
"ms.date": "09/25/2017",
8282
"ms.topic": "reference",
8383
"ms.service": "exchange-powershell",
84+
"products": [
85+
"https://authoring-docs-microsoft.poolparty.biz/devrel/0b654e73-5728-4af3-8c2e-17bfbf4c9f23",
86+
"https://authoring-docs-microsoft.poolparty.biz/devrel/8bce367e-2e90-4b56-9ed5-5e4e9f3a2dc3"
87+
],
8488
"ms.devlang": "powershell",
8589
"feedback_system": "GitHub",
8690
"feedback_github_repo": "MicrosoftDocs/office-docs-powershell",

exchange/docs-conceptual/app-only-auth-powershell-v2.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -54,15 +54,15 @@ The following examples show how to use the Exchange Online PowerShell V2 module
5454
>
5555
> - In the **Connect-ExchangeOnline** commands, be sure to use an `.onmicrosoft.com` domain in the _Organization_ parameter value. Otherwise, you might encounter cryptic permission issues when you run commands in the app context.
5656
>
57-
> - App-only authentication does not support delegation. Unattended scripting in delegation scenarios is supported with the Secure App Model. For more information, go [here](https://docs.microsoft.com/powershell/partnercenter/multi-factor-auth#exchange).
57+
> - App-only authentication does not support delegation. Unattended scripting in delegation scenarios is supported with the Secure App Model. For more information, go [here](/powershell/partnercenter/multi-factor-auth#exchange).
5858
5959
## How does it work?
6060

6161
The EXO V2 module uses the Active Directory Authentication Library to fetch an app-only token using the application Id, tenant Id (organization), and certificate thumbprint. The application object provisioned inside Azure AD has a Directory Role assigned to it, which is returned in the access token. Exchange Online configures the session RBAC using the directory role information that's available in the token.
6262

6363
## Set up app-only authentication
6464

65-
An initial onboarding is required for authentication using application objects. Application and service principal are used interchangeably, but an application is like a class object while a service principal is like an instance of the class. You can learn more about this at [Application and service principal objects in Azure Active Directory](https://docs.microsoft.com/azure/active-directory/develop/app-objects-and-service-principals).
65+
An initial onboarding is required for authentication using application objects. Application and service principal are used interchangeably, but an application is like a class object while a service principal is like an instance of the class. You can learn more about this at [Application and service principal objects in Azure Active Directory](/azure/active-directory/develop/app-objects-and-service-principals).
6666

6767
For a detailed visual flow about creating applications in Azure AD, see <https://aka.ms/azuread-app>.
6868

@@ -101,7 +101,7 @@ For a detailed visual flow about creating applications in Azure AD, see <https:/
101101

102102
## Step 1: Register the application in Azure AD
103103

104-
**Note**: If you encounter problems, check the [required permissions](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal#required-permissions) to verify that your account can create the identity.
104+
**Note**: If you encounter problems, check the [required permissions](/azure/active-directory/develop/howto-create-service-principal-portal#required-permissions) to verify that your account can create the identity.
105105

106106
1. Open the Azure AD portal at <https://portal.azure.com/>.
107107

@@ -125,7 +125,7 @@ For a detailed visual flow about creating applications in Azure AD, see <https:/
125125

126126
- **Redirect URI (optional)**: In the first box, verify that **Web** is selected. In the second box, enter the URI where the access token is sent.
127127

128-
Note that you can't create credentials for [native applications](https://docs.microsoft.com/azure/active-directory/manage-apps/application-proxy-configure-native-client-application), because you can't use that type for automated applications.
128+
Note that you can't create credentials for [native applications](/azure/active-directory/manage-apps/application-proxy-configure-native-client-application), because you can't use that type for automated applications.
129129

130130
![Register an application](media/exo-app-only-auth-register-app.png)
131131

@@ -186,7 +186,7 @@ For a detailed visual flow about creating applications in Azure AD, see <https:/
186186

187187
Create a self-signed x.509 certificate using one of the following methods:
188188

189-
- (Recommended) Use the [New-SelfSignedCertificate](https://docs.microsoft.com/powershell/module/pkiclient/new-selfsignedcertificate), [Export-Certificate](https://docs.microsoft.com/powershell/module/pkiclient/export-certificate) and [Export-PfxCertificate](https://docs.microsoft.com/powershell/module/pkiclient/export-pfxcertificate) cmdlets in an elevated (run as administrator) Windows PowerShell session to request a self-signed certificate and export it to `.cer` and `.pfx` (SHA1 by default). For example:
189+
- (Recommended) Use the [New-SelfSignedCertificate](/powershell/module/pkiclient/new-selfsignedcertificate), [Export-Certificate](/powershell/module/pkiclient/export-certificate) and [Export-PfxCertificate](/powershell/module/pkiclient/export-pfxcertificate) cmdlets in an elevated (run as administrator) Windows PowerShell session to request a self-signed certificate and export it to `.cer` and `.pfx` (SHA1 by default). For example:
190190

191191
```powershell
192192
# Create certificate
@@ -207,7 +207,7 @@ Create a self-signed x.509 certificate using one of the following methods:
207207

208208
## Step 4: Attach the certificate to the Azure AD application
209209

210-
After you register the certificate with your application, you can use the public key (`.pfx` file) or the thumbprint for authentication.
210+
After you register the certificate with your application, you can use the private key (`.pfx` file) or the thumbprint for authentication.
211211

212212
1. On the **Apps registration** page from the end of [Step 2](#step-2-assign-api-permissions-to-the-application), select your application.
213213

@@ -251,7 +251,7 @@ Azure AD has more than 50 admin roles available. For app-only authentication in
251251
- Exchange administrator
252252
- Global Reader
253253

254-
For general instructions about assigning roles in Azure AD, see [View and assign administrator roles in Azure Active Directory](https://docs.microsoft.com/azure/active-directory/roles/manage-roles-portal).
254+
For general instructions about assigning roles in Azure AD, see [View and assign administrator roles in Azure Active Directory](/azure/active-directory/roles/manage-roles-portal).
255255

256256
1. On the Azure AD portal at <https://portal.azure.com/>, under **Manage Azure Active Directory**, click **View**.
257257

exchange/docs-conceptual/basic-auth-connect-to-eop-powershell.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ The following introductory video shows you how to connect to and use Exchange On
3333

3434
- **The procedures in this article are only for EOP organizations that don't have Exchange Online mailboxes** (for example, you have a standalone EOP subscription that protects your on-premises email environment). If you have a Microsoft 365 subscription includes Exchange Online mailboxes, you can't connect to Exchange Online Protection PowerShell. The same features are available in [Exchange Online PowerShell](exchange-online-powershell.md).
3535

36-
- After you connect, the cmdlets and parameters that you have or don't have access to is controlled by role-based access control (RBAC). For more information, see [Permissions in standalone EOP](https://docs.microsoft.com/microsoft-365/security/office-365-security/feature-permissions-in-eop).
36+
- After you connect, the cmdlets and parameters that you have or don't have access to is controlled by role-based access control (RBAC). For more information, see [Permissions in standalone EOP](/microsoft-365/security/office-365-security/feature-permissions-in-eop).
3737

3838
- You can use the following versions of Windows:
3939

@@ -45,7 +45,7 @@ The following introductory video shows you how to connect to and use Exchange On
4545
- Windows 7 Service Pack 1 (SP1)<sup>\*</sup>
4646
- Windows Server 2008 R2 SP1<sup>\*</sup>
4747

48-
<sup>\*</sup> This version of Windows has reached end of support, and is now supported only in Azure virtual machines. To use this version of Windows, you need to install the Microsoft .NET Framework 4.5 or later and then an updated version of the Windows Management Framework: 3.0, 4.0, or 5.1 (only one). For more information, see [Install the .NET Framework](https://docs.microsoft.com/dotnet/framework/install/on-windows-7), [Windows Management Framework 3.0](https://aka.ms/wmf3download), [Windows Management Framework 4.0](https://aka.ms/wmf4download), and [Windows Management Framework 5.1](https://aka.ms/wmf5download).
48+
<sup>\*</sup> This version of Windows has reached end of support, and is now supported only in Azure virtual machines. To use this version of Windows, you need to install the Microsoft .NET Framework 4.5 or later and then an updated version of the Windows Management Framework: 3.0, 4.0, or 5.1 (only one). For more information, see [Install the .NET Framework](/dotnet/framework/install/on-windows-7), [Windows Management Framework 3.0](https://aka.ms/wmf3download), [Windows Management Framework 4.0](https://aka.ms/wmf4download), and [Windows Management Framework 5.1](https://aka.ms/wmf5download).
4949

5050
- Windows PowerShell needs to be configured to run scripts, and by default, it isn't. You'll get the following error when you try to connect:
5151

@@ -57,7 +57,7 @@ The following introductory video shows you how to connect to and use Exchange On
5757
Set-ExecutionPolicy RemoteSigned
5858
```
5959

60-
For more information about execution policies, see [About Execution Policies](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_execution_policies).
60+
For more information about execution policies, see [About Execution Policies](/powershell/module/microsoft.powershell.core/about/about_execution_policies).
6161

6262
- WinRM needs to allow Basic authentication (it's enabled by default). We don't send the username and password combination, but the Basic authentication header is required to send the session's OAuth token, since the client-side WinRM implementation has no support for OAuth.
6363

@@ -131,7 +131,7 @@ If you receive errors, check the following requirements:
131131

132132
- TCP port 80 traffic needs to be open between your local computer and Microsoft 365. It's probably open, but it's something to consider if your organization has a restrictive Internet access policy.
133133

134-
- The account you use to connect to Exchange Online Protection PowerShell must be represented as a [mail user in EOP](https://docs.microsoft.com/microsoft-365/security/office-365-security/manage-mail-users-in-eop) (created manually or by directory synchronization). If the account is not visible in the Exchange admin center (EAC) as a mail user at **Recipients** \> **Contacts**, you'll receive the following error when you try to connect:
134+
- The account you use to connect to Exchange Online Protection PowerShell must be represented as a [mail user in EOP](/microsoft-365/security/office-365-security/manage-mail-users-in-eop) (created manually or by directory synchronization). If the account is not visible in the Exchange admin center (EAC) as a mail user at **Recipients** \> **Contacts**, you'll receive the following error when you try to connect:
135135

136136
> Import-PSSession : Running the Get-Command command in a remote session reported the following error: Processing data for a remote command failed with the following error message: The request for the Windows Remote Shell with ShellId <GUID> failed because the shell was not found on the server. Possible causes are: the specified ShellId is incorrect or the shell no longer exists on the server. Provide the correct ShellId or create a new shell and retry the operation.
137137
@@ -145,8 +145,8 @@ If you receive errors, check the following requirements:
145145

146146
The cmdlets that you use in this article are Windows PowerShell cmdlets. For more information about these cmdlets, see the following articles.
147147

148-
- [Get-Credential](https://docs.microsoft.com/powershell/module/microsoft.powershell.security/get-credential)
149-
- [New-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/new-pssession)
150-
- [Import-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.utility/import-pssession)
151-
- [Remove-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/remove-pssession)
152-
- [Set-ExecutionPolicy](https://docs.microsoft.com/powershell/module/microsoft.powershell.security/set-executionpolicy)
148+
- [Get-Credential](/powershell/module/microsoft.powershell.security/get-credential)
149+
- [New-PSSession](/powershell/module/microsoft.powershell.core/new-pssession)
150+
- [Import-PSSession](/powershell/module/microsoft.powershell.utility/import-pssession)
151+
- [Remove-PSSession](/powershell/module/microsoft.powershell.core/remove-pssession)
152+
- [Set-ExecutionPolicy](/powershell/module/microsoft.powershell.security/set-executionpolicy)

exchange/docs-conceptual/basic-auth-connect-to-exo-powershell.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ The following introductory video shows you how to connect to and use Exchange On
3434

3535
- Estimated time to complete: 5 minutes
3636

37-
- After you connect, the cmdlets and parameters that you have or don't have access to is controlled by role-based access control (RBAC). For more information, see [Permissions in Exchange Online](https://docs.microsoft.com/exchange/permissions-exo/permissions-exo).
37+
- After you connect, the cmdlets and parameters that you have or don't have access to is controlled by role-based access control (RBAC). For more information, see [Permissions in Exchange Online](/exchange/permissions-exo/permissions-exo).
3838

3939
- If your on-premises Exchange organization has Exchange Enterprise CAL with Services licenses, you can use the instructions in this article to connect to your EOP organization.
4040

@@ -48,7 +48,7 @@ The following introductory video shows you how to connect to and use Exchange On
4848
- Windows 7 Service Pack 1 (SP1)<sup>*</sup>
4949
- Windows Server 2008 R2 SP1<sup>*</sup>
5050

51-
<sup>\*</sup> This version of Windows has reached end of support, and is now supported only in Azure virtual machines. To use this version of Windows, you need to install the Microsoft .NET Framework 4.5 or later and then an updated version of the Windows Management Framework: 3.0, 4.0, or 5.1 (only one). For more information, see [Install the .NET Framework](https://docs.microsoft.com/dotnet/framework/install/on-windows-7), [Windows Management Framework 3.0](https://aka.ms/wmf3download), [Windows Management Framework 4.0](https://aka.ms/wmf4download), and [Windows Management Framework 5.1](https://aka.ms/wmf5download).
51+
<sup>\*</sup> This version of Windows has reached end of support, and is now supported only in Azure virtual machines. To use this version of Windows, you need to install the Microsoft .NET Framework 4.5 or later and then an updated version of the Windows Management Framework: 3.0, 4.0, or 5.1 (only one). For more information, see [Install the .NET Framework](/dotnet/framework/install/on-windows-7), [Windows Management Framework 3.0](https://aka.ms/wmf3download), [Windows Management Framework 4.0](https://aka.ms/wmf4download), and [Windows Management Framework 5.1](https://aka.ms/wmf5download).
5252

5353
- Windows PowerShell needs to be configured to run scripts, and by default, it isn't. You'll get the following error when you try to connect:
5454

@@ -60,7 +60,7 @@ The following introductory video shows you how to connect to and use Exchange On
6060
Set-ExecutionPolicy RemoteSigned
6161
```
6262

63-
For more information about execution policies, see [About Execution Policies](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_execution_policies).
63+
For more information about execution policies, see [About Execution Policies](/powershell/module/microsoft.powershell.core/about/about_execution_policies).
6464

6565
- WinRM needs to allow Basic authentication (it's enabled by default). We don't send the username and password combination, but the Basic authentication header is required to send the session's OAuth token, since the client-side WinRM implementation has no support for OAuth.
6666

@@ -114,7 +114,7 @@ The following introductory video shows you how to connect to and use Exchange On
114114

115115
Then, add the following parameter and value to the end of the $Session = ... command: `-SessionOption $ProxyOptions`.
116116

117-
For more information, see [New-PSSessionOption](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/new-pssessionoption).
117+
For more information, see [New-PSSessionOption](/powershell/module/microsoft.powershell.core/new-pssessionoption).
118118

119119
3. Run the following command:
120120

@@ -149,10 +149,10 @@ If you receive errors, check the following requirements:
149149

150150
The cmdlets that you use in this article are Windows PowerShell cmdlets. For more information about these cmdlets, see the following articles.
151151

152-
- [Get-Credential](https://docs.microsoft.com/powershell/module/microsoft.powershell.security/get-credential)
153-
- [New-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/new-pssession)
154-
- [Import-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.utility/import-pssession)
155-
- [Remove-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/remove-pssession)
156-
- [Set-ExecutionPolicy](https://docs.microsoft.com/powershell/module/microsoft.powershell.security/set-executionpolicy)
152+
- [Get-Credential](/powershell/module/microsoft.powershell.security/get-credential)
153+
- [New-PSSession](/powershell/module/microsoft.powershell.core/new-pssession)
154+
- [Import-PSSession](/powershell/module/microsoft.powershell.utility/import-pssession)
155+
- [Remove-PSSession](/powershell/module/microsoft.powershell.core/remove-pssession)
156+
- [Set-ExecutionPolicy](/powershell/module/microsoft.powershell.security/set-executionpolicy)
157157

158-
For more information about managing Microsoft 365, see [Manage Microsoft 365 and Office 365](https://docs.microsoft.com/Office365/).
158+
For more information about managing Microsoft 365, see [Manage Microsoft 365 and Office 365](/Office365/).

0 commit comments

Comments
 (0)