Skip to content

Commit 21c9f13

Browse files
authored
Merge branch 'master' into patch-12
2 parents 903ab83 + 20036fd commit 21c9f13

File tree

148 files changed

+1887
-560
lines changed

Some content is hidden

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

148 files changed

+1887
-560
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: 20 additions & 20 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

@@ -193,7 +193,7 @@ Create a self-signed x.509 certificate using one of the following methods:
193193

194194
```powershell
195195
# Create certificate
196-
$mycert = New-SelfSignedCertificate -DnsName "contoso.org" -CertStoreLocation "cert:\LocalMachine\My" -NotAfter (Get-Date).AddYears(1) -KeySpec KeyExchange
196+
$mycert = New-SelfSignedCertificate -DnsName "contoso.org" -CertStoreLocation "cert:\CurrentUser\My" -NotAfter (Get-Date).AddYears(1) -KeySpec KeyExchange
197197
198198
# Export certificate to .pfx file
199199
$mycert | Export-PfxCertificate -FilePath mycert.pfx -Password $(ConvertTo-SecureString -String "P@ssw0Rd1234" -AsPlainText -Force)
@@ -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/exchange-online-powershell-v2.md

Lines changed: 15 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,9 @@ When you report an issue at `exocmdletpreview[at]service[dot]microsoft[dot]com`,
3737
Connect-ExchangeOnline -EnableErrorReporting -LogDirectoryPath <Path to store log file> -LogLevel All
3838
```
3939

40+
> [!NOTE]
41+
> The latest version of EXO V2 module and frequent use of the **Connect-ExchangeOnline** and **Disconnect-ExchangeOnline** cmdlets in a single PowerShell session or script might lead to a memory leak. The best way to avoid this issue is to use the _CommandName_ parameter on the **Connect-ExchangeOnline** cmdlet to limit the cmdlets that are used in the session.
42+
4043
## How the EXO V2 module works
4144

4245
The module contains a small set of exclusive Exchange Online PowerShell cmdlets that are optimized for bulk data retrieval scenarios (think: thousands and thousands of objects). When you first open the module, you'll only see these exclusive cmdlets. After you [connect to your Exchange Online organization](connect-to-exchange-online-powershell.md), you'll see all of the familiar cmdlets that are available in Exchange Online PowerShell.
@@ -383,7 +386,18 @@ For more information about filtering in the EXO V2 module, see [Filters in the E
383386

384387
Unless otherwise noted, the current release of the EXO V2 module contains all features of previous releases.
385388

386-
### Current release: Version 2.0.4
389+
### Current release: Version 2.0.5
390+
391+
- New **Get-OwnerlessGroupPolicy** and **Set-OwnerlessGroupPolicy** cmdlet to manage ownerless Microsoft 365 groups.
392+
393+
> [!NOTE]
394+
> Although the _cmdlets_ are available in the module, the _feature_ is only available to members of a Private Preview.
395+
396+
- New **Get-VivaInsightsSettings** and **Set-VivaInsightsSettings** cmdlets to control user access to Headspace features in Viva Insights.
397+
398+
### Previous releases
399+
400+
#### Version 2.0.4
387401

388402
- PowerShell 7 is officially supported in Windows, Linux, and Apple macOS as described in the [Prerequisites for the EXO V2 module](#prerequisites-for-the-exo-v2-module) section in this article.
389403

@@ -397,8 +411,6 @@ Unless otherwise noted, the current release of the EXO V2 module contains all fe
397411

398412
- The interactive sign-in process now uses a more secure method to fetch access tokens using safe reply URLs.
399413

400-
### Previous releases
401-
402414
#### Version 2.0.3
403415

404416
- General availability of certificate based authentication (CBA), which enables using modern authentication in unattended scripting or background automation scenarios. The available certificate storage locations are:

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/recipientfilter-properties.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -229,7 +229,7 @@ The recipient properties that have been *confirmed* to work with the _RecipientF
229229
|_PublicFolderContacts_|_pFContacts_|String (wildcards accepted in dynamic distribution groups).||
230230
|_PurportedSearchUI_|_msExchPurportedSearchUI_|String (wildcards accepted).||
231231
|_QueryBaseDN_|_msExchQueryBaseDN_|String (wildcards accepted in dynamic distribution groups).||
232-
|_RawCanonicalName_|_canonicalName_|String (wildcards accepted).||
232+
|_RawCanonicalName_|_canonicalName_|String (wildcards accepted).|This property is based on a constructed Active Directory attribute, and does not correctly resolve all members when used in `Get-Recipient -RecipientPreviewFilter`.|
233233
|_RawExternalEmailAddress_|_targetAddress_|String (wildcards accepted).||
234234
|_RawName_|_name_|String (wildcards accepted).||
235235
|_RecipientContainer_|_msExchDynamicDLBaseDN_|String (wildcards accepted).|The Active Directory container or organizational unit (OU) that holds the recipient object.|

0 commit comments

Comments
 (0)