Skip to content

Commit b3d82ea

Browse files
authored
Merge branch 'master' into patch-1
2 parents 1622f62 + ce4d848 commit b3d82ea

Some content is hidden

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

42 files changed

+181
-117
lines changed

README.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
This repository holds reference content of Office PowerShell cmdlets for help purpose. The expert knowledge around Office PowerShell is distributed among customers, MVPs, partners, product teams, support, and other community members. Consumers have various preferences when consuming knowledge such as a website, PowerShell Get-Help, Windows app, iOS app, Android app, and others. The following diagram illustrates the point.
66

7-
![Contribution and Consumption model for Office PowerShell reference content](images/contrib-consumption-model.png)
7+
![Contribution and Consumption model for Office PowerShell reference content.](images/contrib-consumption-model.png)
88

99
## Learn How To Contribute
1010

@@ -19,19 +19,19 @@ Contributors who only make infrequent or small updates can edit the file directl
1919

2020
This brief video also covers how to contribute:
2121

22-
[![Image of Quick Start video](images/edit_video_capture.jpg)](https://support.office.com/article/edit-powershell-cmdlet-in-github-dcd20227-3764-48ce-ad6e-763af8b48daf)
22+
[![Image of Quick Start video.](images/edit_video_capture.jpg)](https://support.office.com/article/edit-powershell-cmdlet-in-github-dcd20227-3764-48ce-ad6e-763af8b48daf)
2323

2424
### Quickly update an article using GitHub.com
2525

2626
1. Make sure you're signed in to GitHub.com with your GitHub account.
2727
2. Go to the page you want to edit on docs.microsoft.com.
2828
3. On the right-hand side of the page, click **Edit** (pencil icon).
2929

30-
![Edit button on docs.microsoft.com](images/quick-update-edit.png)
30+
![Edit button on docs.microsoft.com.](images/quick-update-edit.png)
3131

3232
4. The corresponding topic file on GitHub opens, where you need to click the **Edit this file** pencil icon.
3333

34-
![Edit button on github.com](images/quick-update-github.png)
34+
![Edit button on github.com.](images/quick-update-github.png)
3535

3636
5. The topic opens in a line-numbered editing page where you can make changes to the file.
3737

@@ -45,7 +45,7 @@ This brief video also covers how to contribute:
4545

4646
- Since you are likely not a maintainer of the Git repository, GitHub will automatically 'Fork' the project into your personal GitHub account. A fork is a copy of the repository in your git account. By forking, you can freely make edits without affecting the original repository. You can always find it again by looking at your GitHub Repositories in your GitHub Profile (drop-down from your name in the top right).
4747

48-
![Image of Automatic Fork message on Github](images/auto_fork.png)
48+
![Image of Automatic Fork message on Github.](images/auto_fork.png)
4949

5050
6. You can click the **Preview changes** tab to see what the changes will look like.
5151

@@ -56,15 +56,15 @@ This brief video also covers how to contribute:
5656

5757
When you're ready, click the green **Propose file change** button.
5858

59-
![Propose file change section](images/propose-file-change.png)
59+
![Propose file change section.](images/propose-file-change.png)
6060

6161
8. On the **Comparing changes** page that appears, click the green **Create pull request** button.
6262

63-
![Comparing changes page](images/comparing-changes-page.png)
63+
![Comparing changes page.](images/comparing-changes-page.png)
6464

6565
9. On the **Open a pull request** page that appears, click the green **Create pull request** button.
6666

67-
![Open a pull request page](images/open-a-pull-request-page.png)
67+
![Open a pull request page.](images/open-a-pull-request-page.png)
6868

6969
> [!NOTE]
7070
> Your permissions in the repo determine what you see in the last several steps. People with no special privileges will see the **Propose file change** section and subsequent confirmation pages as described. People with permissions to create and approve their own pull requests will see a similar **Commit changes** section with extra options for creating a new branch and fewer confirmation pages.<br/><br/>The point is: click any green buttons that are presented to you until there are no more.

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

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -110,15 +110,15 @@ For a detailed visual flow about creating applications in Azure AD, see <https:/
110110

111111
2. Under **Manage Azure Active Directory**, click **View**.
112112

113-
![Click View in the Azure AD portal under Manage Azure Active Directory](media/exo-app-only-auth-manage-ad-view.png)
113+
![Click View in the Azure AD portal under Manage Azure Active Directory.](media/exo-app-only-auth-manage-ad-view.png)
114114

115115
3. On the **Overview** page that opens, under **Manage**, select **App registrations**.
116116

117-
![Select App registrations](media/exo-app-only-auth-select-app-registrations.png)
117+
![Select App registrations.](media/exo-app-only-auth-select-app-registrations.png)
118118

119119
4. On the **App registrations** page that opens, click **New registration**.
120120

121-
![Select New registration on the App registrations page](media/exo-app-only-auth-new-app-registration.png)
121+
![Select New registration on the App registrations page.](media/exo-app-only-auth-new-app-registration.png)
122122

123123
On the **Register an application** page that opens, configure the following settings:
124124

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

131131
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.
132132

133-
![Register an application](media/exo-app-only-auth-register-app.png)
133+
![Register an application.](media/exo-app-only-auth-register-app.png)
134134

135135
When you're finished, click **Register**.
136136

@@ -143,7 +143,7 @@ For a detailed visual flow about creating applications in Azure AD, see <https:/
143143
144144
1. On the app page under **Management**, select **Manifest**.
145145

146-
![Select Manifest on the application properties page](media/exo-app-only-auth-select-manifest.png)
146+
![Select Manifest on the application properties page.](media/exo-app-only-auth-select-manifest.png)
147147

148148
2. On the **Manifest** page that opens, find the `requiredResourceAccess` entry (on or about line 44).
149149

@@ -167,21 +167,21 @@ For a detailed visual flow about creating applications in Azure AD, see <https:/
167167

168168
3. Still on the **Manifest** page, under **Management**, select **API permissions**.
169169

170-
![Select API permissions on the application properties page](media/exo-app-only-auth-select-api-permissions.png)
170+
![Select API permissions on the application properties page.](media/exo-app-only-auth-select-api-permissions.png)
171171

172172
On the **API permissions** page that opens, do the following steps:
173173

174174
- **API / Permissions name**: Verify the value **Exchange.ManageAsApp** is shown.
175175

176176
- **Status**: The current incorrect value is **Not granted for \<Organization\>**, and this value needs to be changed.
177177

178-
![Original incorrect API permissions](media/exo-app-only-auth-original-permissions.png)
178+
![Original incorrect API permissions.](media/exo-app-only-auth-original-permissions.png)
179179

180180
Select **Grant admin consent for \<Organization\>**, read the confirmation dialog that opens, and then click **Yes**.
181181

182182
The **Status** value should now be **Granted for \<Organization\>**.
183183

184-
![Admin consent granted](media/exo-app-only-auth-admin-consent-granted.png)
184+
![Admin consent granted.](media/exo-app-only-auth-admin-consent-granted.png)
185185

186186
4. Close the current **API permissions** page (not the browser tab) to return to the **App registrations** page. You'll use it in an upcoming step.
187187

@@ -220,25 +220,25 @@ After you register the certificate with your application, you can use the privat
220220
2. Under **Manage Azure Active Directory**, click **View**.
221221
3. Under **Manage**, select **App registrations**.
222222

223-
![Apps registration page where you select your app](media/exo-app-only-auth-app-registration-page.png)
223+
![Apps registration page where you select your app.](media/exo-app-only-auth-app-registration-page.png)
224224

225225
2. On the application page that opens, under **Manage**, select **Certificates & secrets**.
226226

227-
![Select Certificates & Secrets on the application properties page](media/exo-app-only-auth-select-certificates-and-secrets.png)
227+
![Select Certificates & Secrets on the application properties page.](media/exo-app-only-auth-select-certificates-and-secrets.png)
228228

229229
3. On the **Certificates & secrets** page that opens, click **Upload certificate**.
230230

231-
![Select Upload certificate on the Certificates & secrets page](media/exo-app-only-auth-select-upload-certificate.png)
231+
![Select Upload certificate on the Certificates & secrets page.](media/exo-app-only-auth-select-upload-certificate.png)
232232

233233
In the dialog that opens, browse to the self-signed certificate (`.cer` file) that you created in [Step 3](#step-3-generate-a-self-signed-certificate).
234234

235-
![Browse to the certificate and then click Add](media/exo-app-only-auth-upload-certificate-dialog.png)
235+
![Browse to the certificate and then click Add.](media/exo-app-only-auth-upload-certificate-dialog.png)
236236

237237
When you're finished, click **Add**.
238238

239239
The certificate is now shown in the **Certificates** section.
240240

241-
![Application page showing that the certificate was added](media/exo-app-only-auth-certificate-successfully-added.png)
241+
![Application page showing that the certificate was added.](media/exo-app-only-auth-certificate-successfully-added.png)
242242

243243
4. Close the current **Certificates & secrets** page, and then the **App registrations** page to return to the main <https://portal.azure.com/> page. You'll use it in the next step.
244244

@@ -258,26 +258,26 @@ For general instructions about assigning roles in Azure AD, see [View and assign
258258

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

261-
![View in the Azure AD portal under Manage Azure Active Directory](media/exo-app-only-auth-manage-ad-view.png)
261+
![View in the Azure AD portal under Manage Azure Active Directory.](media/exo-app-only-auth-manage-ad-view.png)
262262

263263
2. On the **Overview** page that opens, under **Manage**, select **Roles and administrators**.
264264

265-
![Select Roles and administrators from the overview page](media/exo-app-only-auth-select-roles-and-administrators.png)
265+
![Select Roles and administrators from the overview page.](media/exo-app-only-auth-select-roles-and-administrators.png)
266266

267267
3. On the **Roles and administrators** page that opens, find and select one of the supported roles by _clicking on the name of the role_ (not the check box) in the results.
268268

269-
![Find and select a supported role by clicking on the role name](media/exo-app-only-auth-find-and-select-supported-role.png)
269+
![Find and select a supported role by clicking on the role name.](media/exo-app-only-auth-find-and-select-supported-role.png)
270270

271271
4. On the **Assignments** page that opens, click **Add assignments**.
272272

273-
![Select Add assignments on the role assignments page](media/exo-app-only-auth-role-assignments-click-add-assignments.png)
273+
![Select Add assignments on the role assignments page.](media/exo-app-only-auth-role-assignments-click-add-assignments.png)
274274

275275
5. In the **Add assignments** flyout that opens, find and select the app that you created in [Step 1](#step-1-register-the-application-in-azure-ad).
276276

277-
![Find and select your app on the Add assignments flyout](media/exo-app-only-auth-find-add-select-app-for-assignment.png)
277+
![Find and select your app on the Add assignments flyout.](media/exo-app-only-auth-find-add-select-app-for-assignment.png)
278278

279279
When you're finished, click **Add**.
280280

281281
6. Back on the **Assignments** page, verify that the app has been assigned to the role.
282282

283-
![The role assignments page after to added the app to the role](media/exo-app-only-auth-app-assigned-to-role.png)
283+
![The role assignments page after to added the app to the role.](media/exo-app-only-auth-app-assigned-to-role.png)

exchange/docs-conceptual/connect-to-exchange-online-powershell.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -104,13 +104,13 @@ For other sign in methods that are available in PowerShell 7, see the [PowerShel
104104

105105
3. In the sign-in window that opens, enter your password, and then click **Sign in**.
106106

107-
![Enter your password in the Sign in to your account window](media/connect-exo-password-prompt.png)
107+
![Enter your password in the Sign in to your account window.](media/connect-exo-password-prompt.png)
108108

109109
4. **MFA only**: A verification code is generated and delivered based on the response option that's configured for your account (for example, a text message or the Microsoft Authenticator app on your device).
110110

111111
In the verification window that opens, enter the verification code, and then click **Verify**.
112112

113-
![Enter your verification code in the Sign in to your account window](media/connect-exo-mfa-verify-prompt.png)
113+
![Enter your verification code in the Sign in to your account window.](media/connect-exo-mfa-verify-prompt.png)
114114

115115
For detailed syntax and parameter information, see [Connect-ExchangeOnline](/powershell/module/exchange/connect-exchangeonline).
116116

exchange/docs-conceptual/recipient-filters.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -202,14 +202,14 @@ When creating your own custom OPath filters, consider the following items:
202202

203203
|Search value|OPath filter <br> enclosed in <br> double quotation marks|OPath filter <br> enclosed in <br> single quotation marks|OPath filter enclosed in <br> braces|
204204
|---|:---:|:---:|:---:|
205-
|`'Text'`|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)||![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
206-
|`"Text"`|||![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
207-
|`'$Variable'`|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|||
208-
|`500`|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
209-
|`'500'`|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)||![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
205+
|`'Text'`|![Check mark.](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)||![Check mark.](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
206+
|`"Text"`|||![Check mark.](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
207+
|`'$Variable'`|![Check mark.](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|||
208+
|`500`|![Check mark.](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|![Check mark.](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|![Check mark.](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
209+
|`'500'`|![Check mark.](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)||![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
210210
|`"500"`|||![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
211-
|`$true`||![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
212-
|`` `$true``|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
211+
|`$true`||![Check mark.](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
212+
|`` `$true``|![Check mark.](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|![Check mark](media/f3b4c351-17d9-42d9-8540-e48e01779b31.png)|
213213
|
214214

215215
- Include the hyphen before all logical or comparison operators. The most common operators include:

exchange/docs-conceptual/v1-module-mfa-connect-to-exo-powershell.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -75,11 +75,11 @@ You need to do the following steps in a browser that supports ClickOnce (for exa
7575

7676
2. In the EAC, go to **Hybrid** > **Setup** and click the appropriate **Configure** button to download the Exchange Online Remote PowerShell Module for multi-factor authentication.
7777

78-
![Download the Exchange Online PowerShell Module from the Hybrid tab in the EAC](media/24645e56-8b11-4c0f-ace4-09bdb2703562.png)
78+
![Download the Exchange Online PowerShell Module from the Hybrid tab in the EAC.](media/24645e56-8b11-4c0f-ace4-09bdb2703562.png)
7979

8080
3. In the **Application Install** window that opens, click **Install**.
8181

82-
![Click Install in the Exchange Online PowerShell Module window](media/0fd389a1-a32d-4e2f-bf5f-78e9b6407d4c.png)
82+
![Click Install in the Exchange Online PowerShell Module window.](media/0fd389a1-a32d-4e2f-bf5f-78e9b6407d4c.png)
8383

8484
- When you use the Exchange Online Remote PowerShell Module, your session will end after one hour, which can be problematic for long-running scripts or processes. To avoid this issue, use [Trusted IPs](/azure/active-directory/authentication/howto-mfa-mfasettings#trusted-ips) to bypass MFA for connections from your intranet. Trusted IPs allow you to connect to Exchange Online PowerShell from your intranet using the old instructions at [Basic auth - Connect to Exchange Online PowerShell](basic-auth-connect-to-exo-powershell.md). Also, if you have servers in a datacenter, be sure to add their public IP addresses to Trusted IPs as described [here](/azure/active-directory/authentication/howto-mfa-mfasettings#enable-the-trusted-ips-feature-by-using-service-settings).
8585

@@ -132,13 +132,13 @@ You need to do the following steps in a browser that supports ClickOnce (for exa
132132

133133
3. In the sign-in window that opens, enter your password, and then click **Sign in**.
134134

135-
![Enter your password in the Exchange Online Remote PowerShell window](media/b85d80d9-1043-4c7c-8f14-d87d8d56b188.png)
135+
![Enter your password in the Exchange Online Remote PowerShell window.](media/b85d80d9-1043-4c7c-8f14-d87d8d56b188.png)
136136

137137
A verification code is generated and delivered based on the verification response option that's configured for your account (for example, a text message or the Azure Authenticator app on your mobile phone).
138138

139139
4. In the verification window that opens, enter the verification code, and then click **Sign in**.
140140

141-
![Enter your verification code in the Exchange Online Remote PowerShell window](media/d3a405ce-5364-4732-a7bb-2cc9c678da2d.png)
141+
![Enter your verification code in the Exchange Online Remote PowerShell window.](media/d3a405ce-5364-4732-a7bb-2cc9c678da2d.png)
142142

143143
> [!NOTE]
144144
> Be sure to disconnect the remote PowerShell session when you're finished. If you close the Exchange Online Remote PowerShell Module window without disconnecting the session, you could use up all the remote PowerShell sessions available to you, and you'll need to wait for the sessions to expire. To disconnect all currently open PowerShell sessions in the current window, run the following command:

0 commit comments

Comments
 (0)