Una legal notice quando accendi il computer

				
					<#
.SYNOPSIS
Imposta il messaggio di benvenuto o "legal message" prima della login al computer a cui l'utente deve dare conferma.
Il titolo può avere una lunghezza massima di 100 caratteri e il corpo del messaggio di 1024. Sono ammessi solo 
caratteri alfanumereci e _ - . , ; :
.DESCRIPTION
Permette di associare un messaggio prima della login al computer, 
l'utente deve dare conferma attraverso il bottone OK.
La configurazione è realizzata impostanto le corrispondenti chiavi dei registri di sistema.
.PARAMETER LoginCaption
Titolo della finestra messaggio (MAX 100 caratteri), sono permessi sono i caratteri: a-zA-Z0-9_-.,;:
.PARAMETER LoginText
Testo del messaggio (MAX 255 caratteri), sono permessi sono i caratteri: a-zA-Z0-9_-.,;:
.PARAMETER LoginTextAppend1
Testo addizionale del messaggio (MAX 255 caratteri), sono permessi sono i caratteri: a-zA-Z0-9_-.,;:
.PARAMETER LoginTextAppend2
Testo addizionale del messaggio (MAX 255 caratteri), sono permessi sono i caratteri: a-zA-Z0-9_-.,;:
.PARAMETER LoginTextAppend3
Testo addizionale del messaggio (MAX 255 caratteri), sono permessi sono i caratteri: a-zA-Z0-9_-.,;:
.PARAMETER Action
Azione da eseguire sul messaggio di benevenuto (Attiva, Disattiva).
.EXAMPLE
-
.LINK
www.epolenghi.it
#>

# DEFINIZIONI DELLE FUNZIONI
# Generazione evento di errore per i monitor Datto RMM
# FRMMErrorLevel: red -> chiude con errore; debug -> non chiude
function set-ErrorTrap {
  param (
    [string]$FErrorMessage,
    [string]$FRMMErrorLevel,
    [string]$FDiagnostic
  )
  write-host "<-Start Result->"
  Write-Host "EM = $FErrorMessage"
  Write-host "<-End Result->"
  if ($FDiagnostic -ne "") {
    write-host  "<-Start Diagnostic->"
    Write-Host $FDiagnostic
    write-host "<-End Diagnostic->"
  }
  switch ($FRMMErrorLevel) {
    red {  
      exit 1
    }
    default {
      write-host "DEBUG $FErrorMessage"
    }
  }  
}

# Lettura campi nei registi
function Get-RegistryValue {
  param (
    [string]$FPath,
    [String]$FField
  )
  try {
    Get-ItemPropertyValue -Path $FPath -Name $FField -ErrorAction:Ignore    
  }
  catch {}
}

# scrittura campi nei registri
function Set-RegistryValue {
  param (
    [String]$FPath,
    [string]$FField,
    [String]$FValue
  )
  Set-ItemProperty -Path $FPath -Name $FField  -Value $FValue -Force | Out-Null
}

# Acquisizione parametri da Datto RMM
$LoginCaption = $ENV:LoginCaption
$LoginText = $ENV:LoginText
$LoginTextAppend1 = $ENV:LoginTextAppend1
$LoginTextAppend2 = $ENV:LoginTextAppend2
$LoginTextAppend3 = $ENV:LoginTextAppend3
$Action = $ENV:Action

# Percorso dei valori dei registri
$LoginPath = "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon"

# Controllo di consistenza dei parametri
If ("Attiva", "Disattiva" -NotContains $Action) {
  set-ErrorTrap -FErrorMessage "ERRORE - Parametro ACTION inconsistente." -FRMMErrorLevel "red" -FDiagnostic ""
}
If ((([string]::IsNullOrEmpty($LoginText) -or [string]::IsNullOrEmpty($LoginCaption))) -and $Action -eq "Attiva") {
  set-ErrorTrap -FErrorMessage "ERRORE - Parametri LOGINCAPTION e/o LOGINTEXT inconsistenti." -FRMMErrorLevel "red" -FDiagnostic ""
}

# Controllo di dimensione dei campi di testo
if($LoginText.length -gt 255) {
  set-ErrorTrap -FErrorMessage "ERRORE - Parametro LOGINTEXT troppi caratteri." -FRMMErrorLevel "red" -FDiagnostic ""
}
if($LoginText.length -gt 100) {
  set-ErrorTrap -FErrorMessage "ERRORE - Parametro LOGINCAPTION troppi caratteri." -FRMMErrorLevel "red" -FDiagnostic ""
}

$LoginText += $LoginTextAppend1 + " " + $LoginTextAppend2 + " " + $LoginTextAppend3

if ($LoginText  -match "[^a-zA-Z0-9_-.,;:]") {
  set-ErrorTrap -FErrorMessage "ERRORE - Parametro LOGINTEXT contiene caratteri non attesi"
}
if ($LoginCaption  -match "[^a-zA-Z0-9_-.,;:]") {
  set-ErrorTrap -FErrorMessage "ERRORE - Parametro LOGINCAPTION contiene caratteri non attesi"
}

# Lettura dei valori esistenti nei registri
$RCaption = Get-RegistryValue -FPath $LoginPath -FField "LegalNoticeCaption" 
$RText = Get-RegistryValue -FPath $LoginPath -FField "LegalNoticeText"

Switch ($Action) {
  Attiva {
    if (!([string]::IsNullOrEmpty($RCaption))) {
      Set-RegistryValue -FPath $LoginPath -FField "LegalNoticeCaption" -FValue $LoginCaption
    }
    if (!([string]::IsNullOrEmpty($RText))) {
      Set-RegistryValue -FPath $LoginPath -FField "LegalNoticeText" -FValue $LoginText
    }
  }
  Disattiva {
    if (([string]::IsNullOrEmpty($RCaption)) -or $RCaption -ne $LoginCaption) {
      Set-RegistryValue -FPath $LoginPath -FField "LegalNoticeCaption" -FValue ""
    }
    if (([string]::IsNullOrEmpty($RText)) -or $RCaption -ne $LoginText) {
      Set-RegistryValue -FPath $LoginPath -FField "LegalNoticeText" -FValue ""
    }
  }
}