From ffd2090ee6644aaaba846d99efd2b1cfc910349f Mon Sep 17 00:00:00 2001
From: merill <1288081+merill@users.noreply.github.com>
Date: Sun, 23 Jun 2024 03:21:29 +0000
Subject: [PATCH] [create-pull-request] automated change

---
 website/docs/commands/Connect-Maester.mdx     | 38 ++++++++++-
 .../commands/Test-MtCisaAntiSpamAllowList.mdx | 65 +++++++++++++++++++
 .../commands/Test-MtCisaAntiSpamSafeList.mdx  | 65 +++++++++++++++++++
 .../commands/Test-MtCisaCalendarSharing.mdx   | 65 +++++++++++++++++++
 .../commands/Test-MtCisaContactSharing.mdx    | 65 +++++++++++++++++++
 .../Test-MtCisaExternalSenderWarning.mdx      | 65 +++++++++++++++++++
 .../commands/Test-MtCisaMailboxAuditing.mdx   | 65 +++++++++++++++++++
 .../Test-MtCisaSmtpAuthentication.mdx         | 65 +++++++++++++++++++
 website/docs/commands/docusaurus.sidebar.js   |  7 ++
 9 files changed, 498 insertions(+), 2 deletions(-)
 create mode 100644 website/docs/commands/Test-MtCisaAntiSpamAllowList.mdx
 create mode 100644 website/docs/commands/Test-MtCisaAntiSpamSafeList.mdx
 create mode 100644 website/docs/commands/Test-MtCisaCalendarSharing.mdx
 create mode 100644 website/docs/commands/Test-MtCisaContactSharing.mdx
 create mode 100644 website/docs/commands/Test-MtCisaExternalSenderWarning.mdx
 create mode 100644 website/docs/commands/Test-MtCisaMailboxAuditing.mdx
 create mode 100644 website/docs/commands/Test-MtCisaSmtpAuthentication.mdx

diff --git a/website/docs/commands/Connect-Maester.mdx b/website/docs/commands/Connect-Maester.mdx
index 825bf002..8f28bc9e 100644
--- a/website/docs/commands/Connect-Maester.mdx
+++ b/website/docs/commands/Connect-Maester.mdx
@@ -24,7 +24,8 @@ Connect-Maester [-SendMail] [-Privileged] [-UseDeviceCode] [[-Environment] <Stri
 
 Use this cmdlet to connect to Microsoft Graph using Connect-MgGraph.
 
-This command is completely optional if you are already connected to Microsoft Graph using Connect-MgGraph with the required scopes.
+This command is completely optional if you are already connected to Microsoft Graph and other services using Connect-MgGraph with the required scopes.
+
 ```
 Connect-MgGraph -Scopes (Get-MtGraphScope)
 ```
@@ -37,18 +38,49 @@ Connect-MgGraph -Scopes (Get-MtGraphScope)
 Connect-Maester
 ```
 
+Connects to Microsoft Graph using Connect-MgGraph with the required scopes.
+
 ### EXAMPLE 2
 
 ```powershell
 Connect-Maester -Service All
 ```
 
+Connects to Microsoft Graph, Azure, and Exchange Online.
+
 ### EXAMPLE 3
 
 ```powershell
 Connect-Maester -Service Azure,Graph
 ```
 
+Connects to Microsoft Graph and Azure.
+
+### EXAMPLE 4
+
+```powershell
+Connect-Maester -UseDeviceCode
+```
+
+Connects to Microsoft Graph and Azure using the device code flow.
+This will open a browser window to prompt for authentication.
+
+### EXAMPLE 5
+
+```powershell
+Connect-Maester -SendMail
+```
+
+Connects to Microsoft Graph with the Mail.Send scope.
+
+### EXAMPLE 6
+
+```powershell
+Connect-Maester -Privileged
+```
+
+Connects to Microsoft Graph with additional privileged scopes such as **RoleEligibilitySchedule.ReadWrite.Directory** that are required for querying global admin roles in Privileged Identity Management.
+
 ## PARAMETERS
 
 ### -SendMail
@@ -70,6 +102,7 @@ Accept wildcard characters: False
 ### -Privileged
 
 If specified, the cmdlet will include the scopes for read write API endpoints.
+This is currently required for querying global admin roles in PIM.
 
 ```yaml
 Type: SwitchParameter
@@ -85,7 +118,8 @@ Accept wildcard characters: False
 
 ### -UseDeviceCode
 
-If specified, the cmdlet will use the device code flow to authenticate.
+If specified, the cmdlet will use the device code flow to authenticate to Graph and Azure.
+This will open a browser window to prompt for authentication and is useful for non-interactive sessions and on Windows when SSO is not desired.
 
 ```yaml
 Type: SwitchParameter
diff --git a/website/docs/commands/Test-MtCisaAntiSpamAllowList.mdx b/website/docs/commands/Test-MtCisaAntiSpamAllowList.mdx
new file mode 100644
index 00000000..6de680a3
--- /dev/null
+++ b/website/docs/commands/Test-MtCisaAntiSpamAllowList.mdx
@@ -0,0 +1,65 @@
+---
+sidebar_class_name: hidden
+description: Checks state of anti-spam policies
+id: Test-MtCisaAntiSpamAllowList
+title: Test-MtCisaAntiSpamAllowList
+hide_title: false
+hide_table_of_contents: false
+custom_edit_url: https://github.com/maester365/maester/blob/main/powershell/public/Test-MtCisaAntiSpamAllowList.ps1
+---
+
+## SYNOPSIS
+
+Checks state of anti-spam policies
+
+## SYNTAX
+
+```powershell
+Test-MtCisaAntiSpamAllowList [-ProgressAction <ActionPreference>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+IP allow lists SHOULD NOT be created.
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+Test-MtCisaAntiSpamAllowList
+```
+
+Returns true if no allowed IPs in anti-spam policy
+
+## PARAMETERS
+
+### -ProgressAction
+
+\{\{ Fill ProgressAction Description \}\}
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### System.Boolean
+
+## NOTES
+
+## RELATED LINKS
diff --git a/website/docs/commands/Test-MtCisaAntiSpamSafeList.mdx b/website/docs/commands/Test-MtCisaAntiSpamSafeList.mdx
new file mode 100644
index 00000000..e53d5bdc
--- /dev/null
+++ b/website/docs/commands/Test-MtCisaAntiSpamSafeList.mdx
@@ -0,0 +1,65 @@
+---
+sidebar_class_name: hidden
+description: Checks state of anti-spam policies
+id: Test-MtCisaAntiSpamSafeList
+title: Test-MtCisaAntiSpamSafeList
+hide_title: false
+hide_table_of_contents: false
+custom_edit_url: https://github.com/maester365/maester/blob/main/powershell/public/Test-MtCisaAntiSpamSafeList.ps1
+---
+
+## SYNOPSIS
+
+Checks state of anti-spam policies
+
+## SYNTAX
+
+```powershell
+Test-MtCisaAntiSpamSafeList [-ProgressAction <ActionPreference>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Safe lists SHOULD NOT be enabled.
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+Test-MtCisaAntiSpamSafeList
+```
+
+Returns true if Safe List is disabled in anti-spam policy
+
+## PARAMETERS
+
+### -ProgressAction
+
+\{\{ Fill ProgressAction Description \}\}
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### System.Boolean
+
+## NOTES
+
+## RELATED LINKS
diff --git a/website/docs/commands/Test-MtCisaCalendarSharing.mdx b/website/docs/commands/Test-MtCisaCalendarSharing.mdx
new file mode 100644
index 00000000..fa1f2561
--- /dev/null
+++ b/website/docs/commands/Test-MtCisaCalendarSharing.mdx
@@ -0,0 +1,65 @@
+---
+sidebar_class_name: hidden
+description: Checks state of sharing policies
+id: Test-MtCisaCalendarSharing
+title: Test-MtCisaCalendarSharing
+hide_title: false
+hide_table_of_contents: false
+custom_edit_url: https://github.com/maester365/maester/blob/main/powershell/public/Test-MtCisaCalendarSharing.ps1
+---
+
+## SYNOPSIS
+
+Checks state of sharing policies
+
+## SYNTAX
+
+```powershell
+Test-MtCisaCalendarSharing [-ProgressAction <ActionPreference>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Calendar details SHALL NOT be shared with all domains.
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+Test-MtCisaCalendarSharing
+```
+
+Returns true if no sharing policies allow uncontrolled calendar sharing.
+
+## PARAMETERS
+
+### -ProgressAction
+
+\{\{ Fill ProgressAction Description \}\}
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### System.Boolean
+
+## NOTES
+
+## RELATED LINKS
diff --git a/website/docs/commands/Test-MtCisaContactSharing.mdx b/website/docs/commands/Test-MtCisaContactSharing.mdx
new file mode 100644
index 00000000..d0db7bd9
--- /dev/null
+++ b/website/docs/commands/Test-MtCisaContactSharing.mdx
@@ -0,0 +1,65 @@
+---
+sidebar_class_name: hidden
+description: Checks state of sharing policies
+id: Test-MtCisaContactSharing
+title: Test-MtCisaContactSharing
+hide_title: false
+hide_table_of_contents: false
+custom_edit_url: https://github.com/maester365/maester/blob/main/powershell/public/Test-MtCisaContactSharing.ps1
+---
+
+## SYNOPSIS
+
+Checks state of sharing policies
+
+## SYNTAX
+
+```powershell
+Test-MtCisaContactSharing [-ProgressAction <ActionPreference>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Contact folders SHALL NOT be shared with all domains.
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+Test-MtCisaContactSharing
+```
+
+Returns true if no sharing policies allow uncontrolled contact sharing.
+
+## PARAMETERS
+
+### -ProgressAction
+
+\{\{ Fill ProgressAction Description \}\}
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### System.Boolean
+
+## NOTES
+
+## RELATED LINKS
diff --git a/website/docs/commands/Test-MtCisaExternalSenderWarning.mdx b/website/docs/commands/Test-MtCisaExternalSenderWarning.mdx
new file mode 100644
index 00000000..541785b5
--- /dev/null
+++ b/website/docs/commands/Test-MtCisaExternalSenderWarning.mdx
@@ -0,0 +1,65 @@
+---
+sidebar_class_name: hidden
+description: Checks state of transport policies
+id: Test-MtCisaExternalSenderWarning
+title: Test-MtCisaExternalSenderWarning
+hide_title: false
+hide_table_of_contents: false
+custom_edit_url: https://github.com/maester365/maester/blob/main/powershell/public/Test-MtCisaExternalSenderWarning.ps1
+---
+
+## SYNOPSIS
+
+Checks state of transport policies
+
+## SYNTAX
+
+```powershell
+Test-MtCisaExternalSenderWarning [-ProgressAction <ActionPreference>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+External sender warnings SHALL be implemented.
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+Test-MtCisaExternalSenderWarning
+```
+
+Returns true if a transport policy appends a warning.
+
+## PARAMETERS
+
+### -ProgressAction
+
+\{\{ Fill ProgressAction Description \}\}
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### System.Boolean
+
+## NOTES
+
+## RELATED LINKS
diff --git a/website/docs/commands/Test-MtCisaMailboxAuditing.mdx b/website/docs/commands/Test-MtCisaMailboxAuditing.mdx
new file mode 100644
index 00000000..30fa5a2f
--- /dev/null
+++ b/website/docs/commands/Test-MtCisaMailboxAuditing.mdx
@@ -0,0 +1,65 @@
+---
+sidebar_class_name: hidden
+description: Checks state of mailbox auditing
+id: Test-MtCisaMailboxAuditing
+title: Test-MtCisaMailboxAuditing
+hide_title: false
+hide_table_of_contents: false
+custom_edit_url: https://github.com/maester365/maester/blob/main/powershell/public/Test-MtCisaMailboxAuditing.ps1
+---
+
+## SYNOPSIS
+
+Checks state of mailbox auditing
+
+## SYNTAX
+
+```powershell
+Test-MtCisaMailboxAuditing [-ProgressAction <ActionPreference>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Mailbox auditing SHALL be enabled.
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+Test-MtCisaMailboxAuditing
+```
+
+Returns true if mailbox auditing is enabled.
+
+## PARAMETERS
+
+### -ProgressAction
+
+\{\{ Fill ProgressAction Description \}\}
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### System.Boolean
+
+## NOTES
+
+## RELATED LINKS
diff --git a/website/docs/commands/Test-MtCisaSmtpAuthentication.mdx b/website/docs/commands/Test-MtCisaSmtpAuthentication.mdx
new file mode 100644
index 00000000..886543a2
--- /dev/null
+++ b/website/docs/commands/Test-MtCisaSmtpAuthentication.mdx
@@ -0,0 +1,65 @@
+---
+sidebar_class_name: hidden
+description: Checks state of SMTP authentication in Exchange Online.
+id: Test-MtCisaSmtpAuthentication
+title: Test-MtCisaSmtpAuthentication
+hide_title: false
+hide_table_of_contents: false
+custom_edit_url: https://github.com/maester365/maester/blob/main/powershell/public/Test-MtCisaSmtpAuthentication.ps1
+---
+
+## SYNOPSIS
+
+Checks state of SMTP authentication in Exchange Online.
+
+## SYNTAX
+
+```powershell
+Test-MtCisaSmtpAuthentication [-ProgressAction <ActionPreference>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+SMTP authentication SHALL be disabled.
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+Test-MtCisaSmtpAuthentication
+```
+
+Returns true if SMTP authentication is disabled in Exchange Online.
+
+## PARAMETERS
+
+### -ProgressAction
+
+\{\{ Fill ProgressAction Description \}\}
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### System.Boolean
+
+## NOTES
+
+## RELATED LINKS
diff --git a/website/docs/commands/docusaurus.sidebar.js b/website/docs/commands/docusaurus.sidebar.js
index 35de3046..6795a5f7 100644
--- a/website/docs/commands/docusaurus.sidebar.js
+++ b/website/docs/commands/docusaurus.sidebar.js
@@ -53,6 +53,8 @@ module.exports = [
     'commands/Test-MtCaSecureSecurityInfoRegistration',
     'commands/Test-MtCaWIFBlockLegacyAuthentication',
     'commands/Test-MtCisaActivationNotification',
+    'commands/Test-MtCisaAntiSpamAllowList',
+    'commands/Test-MtCisaAntiSpamSafeList',
     'commands/Test-MtCisaAppAdminConsent',
     'commands/Test-MtCisaAppGroupOwnerConsent',
     'commands/Test-MtCisaAppRegistration',
@@ -63,12 +65,16 @@ module.exports = [
     'commands/Test-MtCisaBlockHighRiskSignIn',
     'commands/Test-MtCisaBlockHighRiskUser',
     'commands/Test-MtCisaBlockLegacyAuth',
+    'commands/Test-MtCisaCalendarSharing',
     'commands/Test-MtCisaCloudGlobalAdmin',
+    'commands/Test-MtCisaContactSharing',
     'commands/Test-MtCisaDiagnosticSettings',
+    'commands/Test-MtCisaExternalSenderWarning',
     'commands/Test-MtCisaGlobalAdminCount',
     'commands/Test-MtCisaGlobalAdminRatio',
     'commands/Test-MtCisaGuestInvitation',
     'commands/Test-MtCisaGuestUserAccess',
+    'commands/Test-MtCisaMailboxAuditing',
     'commands/Test-MtCisaManagedDevice',
     'commands/Test-MtCisaManagedDeviceRegistration',
     'commands/Test-MtCisaMethodsMigration',
@@ -79,6 +85,7 @@ module.exports = [
     'commands/Test-MtCisaPhishResistant',
     'commands/Test-MtCisaPrivilegedPhishResistant',
     'commands/Test-MtCisaRequireActivationApproval',
+    'commands/Test-MtCisaSmtpAuthentication',
     'commands/Test-MtCisaUnmanagedRoleAssignment',
     'commands/Test-MtCisaWeakFactor',
     'commands/Test-MtConditionalAccessWhatIf',