Getting started with PowerShell Loops Operators Using ShouldProcess PowerShell Classes Switch statement Working with Objects Using existing static classes Basic Set Operations PowerShell Functions Sending Email Handling Secrets and Credentials Powershell Remoting PowerShell "Streams"; Debug, Verbose, Warning, Error, Output and Information Variables in PowerShell Communicating with RESTful APIs Working with the PowerShell pipeline PowerShell Background Jobs Return behavior in PowerShell Working with XML Files Introduction to Psake Using the progress bar Strings TCP Communication with PowerShell SharePoint Module Aliases Automatic Variables Environment Variables Powershell profiles Enforcing script prerequisites Using the Help System Splatting Desired State Configuration Signing Scripts Security and Cryptography CSV parsing Introduction to Pester Modules, Scripts and Functions PowerShell.exe Command-Line Common parameters Parameter sets Regular Expressions PowerShell Dynamic Parameters WMI and CIM GUI in Powershell Conditional logic URL Encode/Decode MongoDB Running Executables Error handling HashTables ActiveDirectory module powershell sql queries Automatic Variables - part 2 Package management Cmdlet Naming Built-in variables Creating DSC Class-Based Resources Powershell Modules PowerShell Workflows How to download latest artifact from Artifactory using Powershell script (v2.0 or below)?Calculated Properties Special Operators Anonymize IP (v4 and v6) in text file with Powershell Comment-based help Amazon Web Services (AWS) Simple Storage Service (S3)Amazon Web Services (AWS) Rekognition PSScriptAnalyzer - PowerShell Script Analyzer Naming Conventions Embedding Managed Code (C# | VB)Archive Module Infrastructure Automation Scheduled tasks module ISE module

Enforcing script prerequisites

Remarks:

#requires statement can be placed on any line in the script (it doesn't have to be the first line) but it must be the first statement on that line.

Multiple #requires statements may be used in one script.

For more reference, please refer to official documentation on Technet - about_about_Requires.

Enforce minimum version of powershell host

#requires -version 4

After trying to run this script in lower version, you will see this error message

.\script.ps1 : The script 'script.ps1' cannot be run because it contained a "#requires" statement at line 1 for Windows PowerShell version 5.0. The version required by the script does not match the currently running version of Windows PowerShell version 2.0.

Enforce running the script as admininstrator

4.0

#requires -RunAsAdministrator

After trying to run this script without admin privileges, you will see this error message

.\script.ps1 : The script 'script.ps1' cannot be run because it contains a "#requires" statement for running as Administrator. The current Windows PowerShell session is not running as Administrator. Start Windows PowerShell by using the Run as Administrator option, and then try running the script again.

Syntax:

#Requires -Version <N>[.<n>]
#Requires –PSSnapin <PSSnapin-Name> [-Version <N>[.<n>]]
#Requires -Modules { <Module-Name> | <Hashtable> }
#Requires –ShellId <ShellId>
#Requires -RunAsAdministrator

Contributors

Topic Id: 5637

Example Ids: 19987,19988

This site is not affiliated with any of the contributors.