https://github.com/pldmgg/MiniLab

Setup a very basic Windows Lab Environment from scratch, or add specific infrastructure components to your existing Domain. Leverages Vagrant Boxes to make deployment faster/easier.
https://github.com/pldmgg/MiniLab

Last synced: 8 days ago
JSON representation

Setup a very basic Windows Lab Environment from scratch, or add specific infrastructure components to your existing Domain. Leverages Vagrant Boxes to make deployment faster/easier.

• Host: GitHub
• URL: https://github.com/pldmgg/MiniLab
• Owner: pldmgg
• License: mit
• Created: 2018-05-27T15:15:29.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2019-11-28T13:24:15.000Z (about 5 years ago)
• Last Synced: 2024-08-14T07:06:38.944Z (4 months ago)
• Language: PowerShell
• Homepage:
• Size: 1.28 MB
• Stars: 6
• Watchers: 4
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - pldmgg/MiniLab - Setup a very basic Windows Lab Environment from scratch, or add specific infrastructure components to your existing Domain. Leverages Vagrant Boxes to make deployment faster/easier. (PowerShell)

README

        
[![Build status](https://ci.appveyor.com/api/projects/status/github/pldmgg/minilab?branch=master&svg=true)](https://ci.appveyor.com/project/pldmgg/minilab/branch/master)

# MiniLab

Setup a very basic Windows Lab Environment from scratch, or add specific infrastructure components to your existing Domain. Leverages Vagrant Boxes to make deployment faster/easier.

Compatible with Windows PowerShell 5.1 and PowerShell Core 6.X (on Windows)

## Getting Started

```powershell

# One time setup

    # Download the repository

    # Unblock the zip

    # Extract the MiniLab folder to a module path (e.g. $env:USERPROFILE\Documents\WindowsPowerShell\Modules\)

# Or, with PowerShell 5 or later or PowerShellGet:

    Install-Module MiniLab

# Import the module.

    Import-Module MiniLab    # Alternatively, Import-Module 

# Get commands in the module

    Get-Command -Module MiniLab

# Get help

    Get-Help  -Full

    Get-Help about_MiniLab

```

## Examples

### Create a New Domain

On your local machine, make sure you have at least 35GB of Hard Drive Space and 4GB of Memory readily available and

create a new Primary Domain Controller...

```powershell

$VagrantVMPassword = ConvertTo-SecureString 'vagrant' -AsPlainText -Force

$VagrantVMAdminCreds = [pscredential]::new("vagrant",$VagrantVMPassword)

$DomainAdminCreds = [pscredential]::new("alpha\alphaadmin",$(Read-Host 'Enter Passsword' -AsSecureString))

Enter Passsword: ************

$LocalAdminAccountCreds = [pscredential]::new("Administrator",$(Read-Host 'Enter Passsword' -AsSecureString))

Enter Passsword: ****************

$CreateDomainSplatParams = @{

    CreateNewVMs                            = $True

    VMStorageDirectory                      = "H:\VirtualMachines"

    NewDomain                               = "alpha.lab"

    PSRemotingCredentials                   = $VagrantVMAdminCreds

    DomainAdminCredentials                  = $DomainAdminCreds

    LocalAdministratorAccountCredentials    = $LocalAdminAccountCreds

}

$CreateDomainResult = Create-Domain @CreateDomainSplatParams

```

### Create a New Domain with Two-Tier PKI (i.e. Root and Subordinate/Issuing/Intermediate Certificate Authorities)

On your local machine, make sure you have at least 100GB of Hard Drive Space and 12GB of Memory readily available and...

```powershell

$VagrantVMPassword = ConvertTo-SecureString 'vagrant' -AsPlainText -Force

$VagrantVMAdminCreds = [pscredential]::new("vagrant",$VagrantVMPassword)

$DomainAdminCreds = [pscredential]::new("alpha\alphaadmin",$(Read-Host 'Enter Passsword' -AsSecureString))

Enter Passsword: ************

$LocalAdminAccountCreds = [pscredential]::new("Administrator",$(Read-Host 'Enter Passsword' -AsSecureString))

Enter Passsword: **************

$CreateTwoTierPKISplatParams = @{

    CreateNewVMs                            = $True

    VMStorageDirectory                      = "H:\VirtualMachines"

    NewDomain                               = "alpha.lab"

    PSRemotingCredentials                   = $VagrantVMAdminCreds

    DomainAdminCredentials                  = $DomainAdminCreds

    LocalAdministratorAccountCredentials    = $LocalAdminAccountCreds

}

Create-TwoTierPKI @CreateTwoTierPKISplatParams

```

### Add Two-Tier PKI to Your Existing Domain

On your local machine, make sure you have at least 70GB of Hard Drive Space and 8GB of Memory readily available and...

```powershell

$VagrantVMPassword = ConvertTo-SecureString 'vagrant' -AsPlainText -Force

$VagrantVMAdminCreds = [pscredential]::new("vagrant",$VagrantVMPassword)

$DomainAdminCreds = [pscredential]::new("alpha\alphaadmin",$(Read-Host 'Enter Passsword' -AsSecureString))

Enter Passsword: ************

$LocalAdminAccountCreds = [pscredential]::new("Administrator",$(Read-Host 'Enter Passsword' -AsSecureString))

Enter Passsword: **************

$CreateTwoTierPKISplatParams = @{

    CreateNewVMs                            = $True

    VMStorageDirectory                      = "H:\VirtualMachines"

    ExistingDomain                          = "alpha.lab"

    PSRemotingCredentials                   = $VagrantVMAdminCreds

    DomainAdminCredentials                  = $DomainAdminCreds

}

Create-TwoTierPKI @CreateTwoTierPKISplatParams

```

## Build

Run Windows PowerShell 5.1 elevated (i.e. 'Run as Administrator') and...

```powershell

git clone https://github.com/pldmgg/MiniLab.git

if (!$(Test-Path "$HOME\ModuleBuilds")) {$null = New-Item -ItemType Directory "$HOME\ModuleBuilds"}

.\MiniLab\build.ps1 *> "$HOME\ModuleBuilds\MiniLab.log"

```

## Notes

* PSGallery: https://www.powershellgallery.com/packages/MiniLab