Setup

The following simple steps are required in order to start using POSHOrigin.

1. Download Windows Management Framework 5 Production Preview

   POSHOrigin uses class based DSC resources therefore PowerShell 5 is required. This is only required on the machine that is executing the configuration.

   If you have Chocolatey already installed on your machine, just run the following to install WMF 5.

   choco install powershell -pre

   To install Chocoletey, run the following:

   iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))

   If you want to install WMF 5 manually, use this link.

2. Download POSHOrigin

   Run the following commands to download the module from GitHub and extract it to your modules folder. Make sure you run PowerShell as Administrator so it can extract the module to ${env:ProgramFiles}\WindowsPowershell\Modules.

   Invoke-WebRequest -Uri 'https://github.com/devblackops/POSHOrigin/archive/master.zip' -OutFile "$env:UserProfile\Downloads\POSHOrigin-master.zip"
   UnBlock-File -Path "$env:UserProfile\Downloads\POSHOrigin-master.zip"
   Expand-Archive -Path "$env:UserProfile\Downloads\POSHOrigin-master.zip" -DestinationPath "$env:ProgramFiles\WindowsPowershell\Modules" -Force
   Move-Item -Path "$env:ProgramFiles\WindowsPowershell\Modules\POSHOrigin-master" -Destination "$env:ProgramFiles\WindowsPowershell\Modules\POSHOrigin"

3. Verify the module

   Verify that the module is correctly installed by running the following:

   Get-Module -Name POSHOrigin -ListAvailable

4. Initialize POSHOrigin

   Initializing POSHOrigin will do the following:

   • Initializes the POSHOrigin configuration repository that will hold default values for cmdlet parameters. By default this will be $env:UserProfile\.poshorigin.
   • Configures the DSC Local Configuration Manager on the local host for PUSH mode.
   • Enables PS remoting.
   • Sets WSMan TrustedHosts to '*' in order to allow PowerShell remoting to a machine by IP address.

   Initialize-POSHOrigin -Verbose