Backup-GroupPolicy.ps1

<#
.SYNOPSIS
Backup-GroupPolicy is used to backup up Group Policy settings and create a reference guide for the backed up policies.


.DESCRIPTION
Backs up group policies and creates a reference file for the backed up GPO's.


.PARAMETER Path
This parameter defines the Local path to save a copy of the Group Policy backups

.PARAMETER Destination
This parameter defines a network share location for temporary drive mappings to save the backed up GPOs


.EXAMPLE
Backup-GroupPolicy -Path "C:\GPOBackups" -Destination -Destination "\\networkshare\files$\GPOBackups"
# This example saves a copy of GPO backups too a folder named using todays date in C:\GPOBackups\ and saves a copy to the network share \\networkshare\files$\GPOBackups


.NOTES
Author: Robert H. Osborne
Alias: tobor
Contact: rosborne@osbornepro.com


.LINK
https://roberthsoborne.com
https://osbornepro.com
https://btps-secpack.com
https://github.com/tobor88
https://gitlab.com/tobor88
https://www.powershellgallery.com/profiles/tobor
https://www.linkedin.com/in/roberthosborne/
https://www.youracclaim.com/users/roberthosborne/badges
https://www.hackthebox.eu/profile/52286

#>
Function Backup-GroupPolicy {
    [CmdletBinding()]
        param(
            [Parameter(
                Mandatory=$True,
                ValueFromPipeline=$True,
                ValueFromPipelineByPropertyName=$True)]
            [System.IO.FileInfo]$Path,

            [Parameter(
                Mandatory=$True,
                ValueFromPipeline=$True,
                ValueFromPipelineByPropertyName=$True)]
            [System.IO.FileInfo]$Destination
            
        ) # End param

    BEGIN
    {
    
        Import-Module -Name GroupPolicy

        $Date = Get-Date -Format M.d.yyyy
        $Paths = $Path, $Destination

        If ((Test-Path -Path $Paths) -eq $False)
        {

            Write-Verbose 'Backup has not been run today. Making a folder using todays date...'
            New-Item -Path $Paths -ItemType 'Directory'

        } # End If
        Else
        {

            Throw 'Backup has already been run today.'

        } # End Else

        Try 
        {
            
            Write-Verbose "Mapping network drive location as defined by the -Destination parameter..."
            New-PsDrive -Name 'G' -PSProvider 'FileSystem' -Root $Destination -Description 'Temp drive mapping for backing up GPOs.' -Scope 'Global' -Persist

        } # End Try
        Catch
        {

            Write-Warning "Drive G is already mapped. Press Ctrl+C to cancel script execution or press enter to continue.`nIf you have the G drive mapped to a network share or drive already this wont work. Change the cmdlet as I am not error handling that you Nancy."
            Pause

        } # End Catch

    } #End BEGIN 

    PROCESS
    {
        Try 
        {

            Write-Verbose "IN PROGRESS: Backing up GPO's to $Path\$Date..."
            Backup-Gpo -All -Path "$Path\$Date" | Out-Null

        } # End Try
        Catch
        {

            $Error[0]    
            Throw "Failed to backup GPO's to $Path\$Date"

        } # End Catch

        Try 
        {

            Write-Verbose "Creating GUID reference for the backed up Group Policies at $Path\$Date\GUIDReference.csv" 
            Get-GPO -All | Select-Object -Property 'DisplayName','GpoId' | Out-File "$Path\$Date\GUIDReference.csv"

            Write-Verbose "Adding GUID Folder descriptions to $Path\$Date\GUIDFolderDescription.csv"
            Get-ChildItem "$Path\$Date" -Directory -Recurse -Force | Out-String | Out-File "$Path\$Date\GUIDFolderDescription.csv"

         }# End Try
        Catch
        {

            Write-Error "There was an issue creating csv file containing GUID reference information."
            $Error[0]

        } # End Catch

    } # End PROCESS

    END 
    {

        Try
        {

            Write-Verbose "Copying $Path to $Destination"
            Copy-Item -Path "$Path\$Date" -Destination $Destination -Recurse -Force

        } # End Try
        Catch
        {

            Write-Error "There was an error copying $Path\$Date to $Destination."
            $Error[0]
        
        } #End Catch
        
        Try
        {

            Write-Verbose "Removing mapped destination drive...."
            Remove-PSDrive -Name 'G' -PSProvider 'FileSystem' -Scope 'Global' -Force

        } # End Try
        Catch
        {

            Write-Error "There was an error removing the mapped PSDrive"
            $Error[0]

        } # End Catch

    } # End END

} # End Function Backup-GroupPolicy

# SIG # Begin signature block
# MIIM9AYJKoZIhvcNAQcCoIIM5TCCDOECAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB
# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR
# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUSlo044ReOmTI7f0Apjjasg3A
# ru+gggn7MIIE0DCCA7igAwIBAgIBBzANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UE
# BhMCVVMxEDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAY
# BgNVBAoTEUdvRGFkZHkuY29tLCBJbmMuMTEwLwYDVQQDEyhHbyBEYWRkeSBSb290
# IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTExMDUwMzA3MDAwMFoXDTMx
# MDUwMzA3MDAwMFowgbQxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6b25hMRMw
# EQYDVQQHEwpTY290dHNkYWxlMRowGAYDVQQKExFHb0RhZGR5LmNvbSwgSW5jLjEt
# MCsGA1UECxMkaHR0cDovL2NlcnRzLmdvZGFkZHkuY29tL3JlcG9zaXRvcnkvMTMw
# MQYDVQQDEypHbyBEYWRkeSBTZWN1cmUgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IC0g
# RzIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC54MsQ1K92vdSTYusw
# ZLiBCGzDBNliF44v/z5lz4/OYuY8UhzaFkVLVat4a2ODYpDOD2lsmcgaFItMzEUz
# 6ojcnqOvK/6AYZ15V8TPLvQ/MDxdR/yaFrzDN5ZBUY4RS1T4KL7QjL7wMDge87Am
# +GZHY23ecSZHjzhHU9FGHbTj3ADqRay9vHHZqm8A29vNMDp5T19MR/gd71vCxJ1g
# O7GyQ5HYpDNO6rPWJ0+tJYqlxvTV0KaudAVkV4i1RFXULSo6Pvi4vekyCgKUZMQW
# OlDxSq7neTOvDCAHf+jfBDnCaQJsY1L6d8EbyHSHyLmTGFBUNUtpTrw700kuH9zB
# 0lL7AgMBAAGjggEaMIIBFjAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
# BjAdBgNVHQ4EFgQUQMK9J47MNIMwojPX+2yz8LQsgM4wHwYDVR0jBBgwFoAUOpqF
# BxBnKLbv9r0FQW4gwZTaD94wNAYIKwYBBQUHAQEEKDAmMCQGCCsGAQUFBzABhhho
# dHRwOi8vb2NzcC5nb2RhZGR5LmNvbS8wNQYDVR0fBC4wLDAqoCigJoYkaHR0cDov
# L2NybC5nb2RhZGR5LmNvbS9nZHJvb3QtZzIuY3JsMEYGA1UdIAQ/MD0wOwYEVR0g
# ADAzMDEGCCsGAQUFBwIBFiVodHRwczovL2NlcnRzLmdvZGFkZHkuY29tL3JlcG9z
# aXRvcnkvMA0GCSqGSIb3DQEBCwUAA4IBAQAIfmyTEMg4uJapkEv/oV9PBO9sPpyI
# BslQj6Zz91cxG7685C/b+LrTW+C05+Z5Yg4MotdqY3MxtfWoSKQ7CC2iXZDXtHwl
# TxFWMMS2RJ17LJ3lXubvDGGqv+QqG+6EnriDfcFDzkSnE3ANkR/0yBOtg2DZ2HKo
# cyQetawiDsoXiWJYRBuriSUBAA/NxBti21G00w9RKpv0vHP8ds42pM3Z2Czqrpv1
# KrKQ0U11GIo/ikGQI31bS/6kA1ibRrLDYGCD+H1QQc7CoZDDu+8CL9IVVO5EFdkK
# rqeKM+2xLXY2JtwE65/3YR8V3Idv7kaWKK2hJn0KCacuBKONvPi8BDABMIIFIzCC
# BAugAwIBAgIIXIhNoAmmSAYwDQYJKoZIhvcNAQELBQAwgbQxCzAJBgNVBAYTAlVT
# MRAwDgYDVQQIEwdBcml6b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMRowGAYDVQQK
# ExFHb0RhZGR5LmNvbSwgSW5jLjEtMCsGA1UECxMkaHR0cDovL2NlcnRzLmdvZGFk
# ZHkuY29tL3JlcG9zaXRvcnkvMTMwMQYDVQQDEypHbyBEYWRkeSBTZWN1cmUgQ2Vy
# dGlmaWNhdGUgQXV0aG9yaXR5IC0gRzIwHhcNMjAxMTE1MjMyMDI5WhcNMjExMTA0
# MTkzNjM2WjBlMQswCQYDVQQGEwJVUzERMA8GA1UECBMIQ29sb3JhZG8xGTAXBgNV
# BAcTEENvbG9yYWRvIFNwcmluZ3MxEzARBgNVBAoTCk9zYm9ybmVQcm8xEzARBgNV
# BAMTCk9zYm9ybmVQcm8wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDJ
# V6Cvuf47D4iFITUSNj0ucZk+BfmrRG7XVOOiY9o7qJgaAN88SBSY45rpZtGnEVAY
# Avj6coNuAqLa8k7+Im72TkMpoLAK0FZtrg6PTfJgi2pFWP+UrTaorLZnG3oIhzNG
# Bt5oqBEy+BsVoUfA8/aFey3FedKuD1CeTKrghedqvGB+wGefMyT/+jaC99ezqGqs
# SoXXCBeH6wJahstM5WAddUOylTkTEfyfsqWfMsgWbVn3VokIqpL6rE6YCtNROkZq
# fCLZ7MJb5hQEl191qYc5VlMKuWlQWGrgVvEIE/8lgJAMwVPDwLNcFnB+zyKb+ULu
# rWG3gGaKUk1Z5fK6YQ+BAgMBAAGjggGFMIIBgTAMBgNVHRMBAf8EAjAAMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMDMA4GA1UdDwEB/wQEAwIHgDA1BgNVHR8ELjAsMCqgKKAm
# hiRodHRwOi8vY3JsLmdvZGFkZHkuY29tL2dkaWcyczUtNi5jcmwwXQYDVR0gBFYw
# VDBIBgtghkgBhv1tAQcXAjA5MDcGCCsGAQUFBwIBFitodHRwOi8vY2VydGlmaWNh
# dGVzLmdvZGFkZHkuY29tL3JlcG9zaXRvcnkvMAgGBmeBDAEEATB2BggrBgEFBQcB
# AQRqMGgwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmdvZGFkZHkuY29tLzBABggr
# BgEFBQcwAoY0aHR0cDovL2NlcnRpZmljYXRlcy5nb2RhZGR5LmNvbS9yZXBvc2l0
# b3J5L2dkaWcyLmNydDAfBgNVHSMEGDAWgBRAwr0njsw0gzCiM9f7bLPwtCyAzjAd
# BgNVHQ4EFgQUkWYB7pDl3xX+PlMK1XO7rUHjbrwwDQYJKoZIhvcNAQELBQADggEB
# AFSsN3fgaGGCi6m8GuaIrJayKZeEpeIK1VHJyoa33eFUY+0vHaASnH3J/jVHW4BF
# U3bgFR/H/4B0XbYPlB1f4TYrYh0Ig9goYHK30LiWf+qXaX3WY9mOV3rM6Q/JfPpf
# x55uU9T4yeY8g3KyA7Y7PmH+ZRgcQqDOZ5IAwKgknYoH25mCZwoZ7z/oJESAstPL
# vImVrSkCPHKQxZy/tdM9liOYB5R2o/EgOD5OH3B/GzwmyFG3CqrqI2L4btQKKhm+
# CPrue5oXv2theaUOd+IYJW9LA3gvP/zVQhlOQ/IbDRt7BibQp0uWjYaMAOaEKxZN
# IksPKEJ8AxAHIvr+3P8R17UxggJjMIICXwIBATCBwTCBtDELMAkGA1UEBhMCVVMx
# EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAYBgNVBAoT
# EUdvRGFkZHkuY29tLCBJbmMuMS0wKwYDVQQLEyRodHRwOi8vY2VydHMuZ29kYWRk
# eS5jb20vcmVwb3NpdG9yeS8xMzAxBgNVBAMTKkdvIERhZGR5IFNlY3VyZSBDZXJ0
# aWZpY2F0ZSBBdXRob3JpdHkgLSBHMgIIXIhNoAmmSAYwCQYFKw4DAhoFAKB4MBgG
# CisGAQQBgjcCAQwxCjAIoAKAAKECgAAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcC
# AQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkEMRYE
# FK2JyX4lFhUbiLnJZ8T3q4UKfLoZMA0GCSqGSIb3DQEBAQUABIIBAE1Z69sz1L8v
# cwThmyqHfP3nQ5Cm/onvyqEd+9xpPyzaNzTYNpy7ADiNh1yJCi/0PV1iPGqpb8Dv
# IROeSwE42u9VHa83PcQuBPqP7VLcc2KuoLOAITp/klQraXXyL0zpoDq807D7+MqS
# hBrAJsTZk5AlpzeRukijqy49FQgkUXqPvsRtXhaTHng5OoOKM7Hcs7Rb+krX2Cgz
# 3ClODU1ku5zhMoM9DrnKJbwldIF+Vjq8mHdYeF+OUGW0Jb3nxfrLPiR8lAQh2qx6
# 7pp4mSv0GcUPzv++WqpOw3cChgUfC6M2JCN4IN58z9s//FXyd9jQGxk++qlAB0S/
# hVgBLpci2Mg=
# SIG # End signature block