Skip to content

Commit

Permalink
Added doco for Gov cloud.
Browse files Browse the repository at this point in the history
  • Loading branch information
merill committed Nov 25, 2024
1 parent cb15c2c commit a1d52cd
Show file tree
Hide file tree
Showing 2 changed files with 52 additions and 3 deletions.
26 changes: 23 additions & 3 deletions powershell/public/Connect-Maester.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,26 @@
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.
.EXAMPLE
Connect-Maester -Environment USGov -AzureEnvironment AzureUSGovernment -ExchangeEnvironmentName O365USGovGCCHigh
Connects to US Government environments for Microsoft Graph, Azure, and Exchange Online.
.EXAMPLE
Connect-Maester -Environment USGovDoD -AzureEnvironment AzureUSGovernment -ExchangeEnvironmentName O365USGovDoD
Connects to US Department of Defense (DoD) environments for Microsoft Graph, Azure, and Exchange Online.
.EXAMPLE
Connect-Maester -Environment China -AzureEnvironment AzureChinaCloud -ExchangeEnvironmentName O365China
Connects to China environments for Microsoft Graph, Azure, and Exchange Online.
.EXAMPLE
Connect-Maester -Environment Germany
Connects to the Germany environment for Microsoft Graph.
.LINK
https://maester.dev/docs/commands/Connect-Maester
#>
Expand All @@ -67,15 +87,15 @@ function Connect-Maester {
# 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.
[switch] $UseDeviceCode,

# The environment to connect to. Default is Global.
# The environment to connect to. Default is Global. Supported values include China, Germany, Global, USGov, USGovDoD.
[ValidateSet("China", "Germany", "Global", "USGov", "USGovDoD")]
[string]$Environment = "Global",

# The Azure environment to connect to. Default is AzureCloud.
# The Azure environment to connect to. Default is AzureCloud. Supported values include AzureChinaCloud, AzureCloud, AzureUSGovernment.
[ValidateSet("AzureChinaCloud", "AzureCloud", "AzureUSGovernment")]
[string]$AzureEnvironment = "AzureCloud",

# The Exchange environment to connect to. Default is O365Default.
# The Exchange environment to connect to. Default is O365Default. Supported values include O365China, O365Default, O365GermanyCloud, O365USGovDoD, O365USGovGCCHigh.
[ValidateSet("O365China", "O365Default", "O365GermanyCloud", "O365USGovDoD", "O365USGovGCCHigh")]
[string]$ExchangeEnvironmentName = "O365Default",

Expand Down
29 changes: 29 additions & 0 deletions website/docs/connect-maester/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,3 +93,32 @@ If you need to connect to just a subset of the services you can specifiy them us
```powershell
Connect-Maester -Service Azure,Graph
```

### Connect to US Government, US DoD, China and Germany and other clouds

`Connect-Maester` also provides options to connect to the US Government, China and Germany clouds for Microsoft Graph, Azure and Exchange Online.


#### US Government

```powershell
Connect-Maester -Environment USGov -AzureEnvironment AzureUSGovernment -ExchangeEnvironmentName O365USGovGCCHigh
```

#### US Department of Defense (DoD)

```powershell
Connect-Maester -Environment USGovDoD -AzureEnvironment AzureUSGovernment -ExchangeEnvironmentName O365USGovDoD
```

#### China

```powershell
Connect-Maester -Environment China -AzureEnvironment AzureChinaCloud -ExchangeEnvironmentName O365China
```

#### Germany

```powershell
Connect-Maester -Environment Germany
```

0 comments on commit a1d52cd

Please sign in to comment.