Skip to content

Commit

Permalink
Added FAQ and missing docs for tests
Browse files Browse the repository at this point in the history
  • Loading branch information
merill committed Apr 2, 2024
1 parent ed572b2 commit 116a8db
Show file tree
Hide file tree
Showing 7 changed files with 122 additions and 21 deletions.
19 changes: 19 additions & 0 deletions website/docs/faq.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
sidebar_position: 6
title: ❓ FAQ
---

## Previously installed 'Pester' version '3.4.0' conflicts with new module

If you see the following error when installing Maester, it means that you have an older version of Pester installed.

`A Microsoft-signed module named 'Pester' with version '3.4.0' that was previously installed conflicts with the new module 'Pester'`

Run the following command to install the latest version of Pester and then retry installing Maester.

```powershell
Install-Module Pester -Scope CurrentUser -SkipPublisherCheck -Force
```

To learn more or if you run into Pester installation issues see [Pester Installation and Update](https://pester.dev/docs/introduction/installation)

22 changes: 1 addition & 21 deletions website/docs/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,34 +21,14 @@ cd maester-tests
Install-MaesterTests .\tests
```

- Sign in and run the tests.
- Sign into your Microsoft 365 tenant and run the tests.

```powershell
Connect-Maester
Invoke-Maester
```

FAQ

### Previously install 'Pester' version '3.4.0' conflicts with new module.

If you see the following error when installing Maester, it means that you have an older version of Pester installed.

```
A Microsoft-signed module named 'Pester' with version '3.4.0' that was previously installed conflicts with the new module 'Pester'
```

Run the following command to install the latest version of Pester and then retry installing Maester.

```powershell
Install-Module Pester -Scope CurrentUser -SkipPublisherCheck -Force
```



### Prerequisites

* Install git from [https://git-scm.com/](https://git-scm.com/)


## Reporting Test Results
Expand Down
35 changes: 35 additions & 0 deletions website/docs/tests/maester/MT.1021.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
title: Security Defaults are enabled
description: Security defaults make it easier to help protect your organization from identity-related attacks like password spray, replay, and phishing.
slug: /tests/MT.1021
sidebar_class_name: hidden
---

# Security Defaults are enabled

## Description

Security defaults make it easier to help protect your organization from identity-related attacks like password spray, replay, and phishing.

When enabled, the following controls are applied to your tenant:

- Requiring all users to register for multifactor authentication
- Requiring administrators to do multifactor authentication
- Requiring users to do multifactor authentication when necessary
- Blocking legacy authentication protocols
- Protecting privileged activities like access to the Azure portal


## How to fix

To enable security defaults:

- Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [Security Administrator](https://learn.microsoft.com/entra/identity/role-based-access-control/permissions-reference#security-administrator).
- Browse to **Identity** > **Overview** > **Properties**.
- Select **Manage security defaults**.
- Set **Security defaults** to **Enabled**.
- Select **Save**.

## Learn more

- [Security defaults in Microsoft Entra ID](https://learn.microsoft.com/entra/fundamentals/security-defaults)
20 changes: 20 additions & 0 deletions website/docs/tests/maester/MT.1022.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: P1 license usage is above the number of available licences
description: More users are using P1 features than the number of available licenses
slug: /docs/tests/MT.1022
sidebar_class_name: hidden
---

# P1 license usage is above the number of available licences

## Description

More users are using P1 features than the number of available licenses.

## How to fix

Ensure adequate P1 licenses are available for all users using P1 features.

## Learn more

- [Entra ID License utilization report](https://entra.microsoft.com/#view/Microsoft_AAD_IAM/UsageAndInsightsMenuBlade/~/License%20Utilization)
20 changes: 20 additions & 0 deletions website/docs/tests/maester/MT.1023.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: P2 license usage is above the number of available licenses
description: More users are using P2 features than the number of available licenses
slug: /docs/tests/MT.1023
sidebar_class_name: hidden
---

# P2 license usage is above the number of available licenses

## Description

More users are using P2 features than the number of available licenses.

## How to fix

Ensure adequate P2 licenses are available for all users using P1 features.

## Learn more

- [Entra ID License utilization report](https://entra.microsoft.com/#view/Microsoft_AAD_IAM/UsageAndInsightsMenuBlade/~/License%20Utilization)
26 changes: 26 additions & 0 deletions website/docs/tests/maester/MT.1024.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
title: Microsoft Entra recommendations
description: These recommendations help ensure your tenant is in a secure and healthy state
slug: /docs/tests/MT.1024
sidebar_class_name: hidden
---

# Microsoft Entra recommendations

## Description

The Microsoft Entra recommendations feature helps monitor the status of your tenant so you don't have to. These recommendations help ensure your tenant is in a secure and healthy state while also helping you maximize the value of the features available in Microsoft Entra ID.

All these Microsoft Entra recommendations provide you with personalized insights with actionable guidance to:

- Help you identify opportunities to implement best practices for Microsoft Entra related features.
- Improve the state of your Microsoft Entra tenant.
- Optimize the configurations for your scenarios.

## How to fix

Review the notes in the Maester test results that provide detailed steps on how to address the recommendations.

## Learn more

- [What are Microsoft Entra recommendations?](https://learn.microsoft.com/en-us/entra/identity/monitoring-health/overview-recommendations)
1 change: 1 addition & 0 deletions website/sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ const sidebars = {
items: [{ type: "autogenerated", dirName: "monitoring" }],
},
"contributing",
"faq",
{
type: "html",
value: '<span class="sidebar-divider" />',
Expand Down

0 comments on commit 116a8db

Please sign in to comment.