@GitHub Copilot - Welcome @BanterBoy, I’m your Copilot and I’m here to help you get things done faster. I can identify issues, explain and even improve code.

You can ask generic questions, but what I’m really good at is helping you with your code. For example:

Generate unit tests for my code Explain the selected code Propose a fix for the bugs in my code If you want to learn more about my capabilities and limitations, check out the Copilot documentation.

I’m powered by AI, so surprises and mistakes are possible. Make sure to verify any generated code or suggestions, and share feedback so that we can learn and improve.

@BanterBoy: - Explain what the script does and why it is useful.

@GitHub Copilot -


Function Lock-Screen {
        # number of seconds to lock
        $LockSeconds = 10,

        # message shown. Use {0} to insert remaining seconds
        # do not use {0} for a static message
        $Title = 'wait for {0} more seconds...',

        # dim screen

    # when run without administrator privileges, the keyboard will not be blocked!

    # get access to API functions that block user input
    # blocking of keyboard input requires admin privileges
    $code = @'
   public static extern int ShowCursor(bool bShow);

   public static extern bool BlockInput(bool fBlockIt);

    $userInput = Add-Type -MemberDefinition $code -Name Blocker -Namespace UserInput -PassThru

    # get access to UI functionality
    Add-Type -AssemblyName PresentationFramework
    Add-Type -AssemblyName PresentationCore

    # set window opacity
    $opacity = 1
    if ($DimScreen) { $opacity = 200 }

    # create a message label
    $label = New-Object -TypeName Windows.Controls.Label
    $label.FontSize = 60
    $label.FontFamily = 'Consolas'
    $label.FontWeight = 'Bold'
    $label.Background = 'Transparent'
    $label.Foreground = 'Blue'
    $label.VerticalAlignment = 'Center'
    $label.HorizontalAlignment = 'Center'

    # create a window
    $window = New-Object -TypeName Windows.Window
    $window.WindowStyle = 'None'
    $window.AllowsTransparency = $true
    $color = [Windows.Media.Color]::FromArgb($opacity , 0, 0, 0)
    $window.Background = [Windows.Media.SolidColorBrush]::new( $color)
    $window.Opacity = 0.8
    $window.Left = $window.Top = 0
    $window.WindowState = 'Maximized'
    $window.Topmost = $true
    $window.Content = $label

    # block user input
    $null = $userInput::BlockInput($true)
    $null = $userInput::ShowCursor($false)

    # show window and display message
    $null = $window.Dispatcher.Invoke{
        $LockSeconds..1 | ForEach-Object {
            $label.Content = ($title -f $_)
            $label.Dispatcher.Invoke([Action] { } , 'Background')
            Start-Sleep -Seconds 1

    # unblock user input
    $null = $userInput::ShowCursor($true)
    $null = $userInput::BlockInput($false)

Back to Top


Please feel free to copy parts of the script or if you would like to download the entire script, simple click the download button. You can download the complete repository in a zip file by clicking the Download link in the menu bar on the left hand side of the page.

Report Issues

You can report an issue or contribute to this site on GitHub. Simply click the button below and add any relevant notes. I will attempt to respond to all issues as soon as possible.


Back to Top