Import-GCHostsFile.ps1

<#
.SYNOPSIS
  Overwrites the hosts file with the source file.
.DESCRIPTION
  If the source file exists it will clobber the hosts file
  by being coppied over the top of it.

  Type 'Get-Help Import-GCHostsFile -Online' for extra information.
.PARAMETER Path
  The source path including file name to replace the
  existing hosts file.
.PARAMETER Force
  Prevents the confirmation dialog from being displayed.
#>
function Import-GCHostsFile {
  [CmdletBinding(HelpUri = 'https://github.com/grantcarthew/ps-gcpowershell')]
  [OutputType([Int])]
  Param (
    [Parameter(Mandatory=$true,
               Position=0)]
    [String]
    $Path,

    [Parameter(Mandatory=$false,
               Position=1)]
    [Switch]
    $Force
  )
  Write-Verbose -Message "Function initiated: $($MyInvocation.MyCommand)"
  Import-Module -Name GCTest

  $hostsFilePath = Join-Path -Path $env:SystemRoot -ChildPath '\System32\drivers\etc\hosts'
  Write-Verbose -Message "Hosts file path set to: $hostsFilePath"

  if (-not (Test-GCFileWrite -Path $hostsFilePath)) {
    Write-Error -Message "Can't write to the hosts file. Check it exists and you have write permissions."
    Exit
  }

  if (-not (Test-Path -Path $Path)) {
    Write-Warning -Message "The source file does not exists."
  } else {
    Write-Verbose -Message "Importing hosts file from: $Path"
    $pleaseConfirm = -not $Force
    Copy-Item -Path $Path -Destination $hostsFilePath -Force -Confirm:$pleaseConfirm
  }

  Write-Verbose -Message "Function completed: $($MyInvocation.MyCommand)"
}