about_requires - PowerShell


 

Prevents a script from running by requiring the specified snap-ins and (about_requires)

   
# TOPIC
about_Requires

# SHORT DESCRIPTION
Prevents a script from running by requiring the specified snap-ins and
version.

# LONG DESCRIPTION
The #Requires statement prevents a script from running unless the Windows
PowerShell version, snap-in, and snap-in version prerequisites are met. If
the prerequisites are not met, Windows PowerShell does not run the script.

You can use #Requires statements in any script. You cannot use them in
functions, cmdlets, or snap-ins.

Syntax

Use the following syntax to specify the snap-in and the version of the
snap-in that you want to require:

#requires -PsSnapIn <PsSnapIn> [-Version <N>[.<n>]]

Use the following syntax to specify the minimum version of
Windows PowerShell that you want to require:

#requires -Version <N>[.<n>]

Use the following syntax to specify the shell that you want to require:

#requires -ShellId <ShellId>

Rules for Use

- The #Requires statement must be the first item on a line in a script.

- A script can include more than one #Requires statement.

- The #Requires statements can appear on any line in a script.

Examples

The following statement requires the Microsoft.PowerShell.Security
snap-in:

#requires -PsSnapIn Microsoft.PowerShell.Security

If the Microsoft.PowerShell.Security snap-in is not loaded, the script
does not run, and Windows PowerShell displays the following error
message:

"The script '<script-name>' cannot be run because the following
Windows PowerShell snap-ins that are specified by its "#requires"
statements are missing: Microsoft.PowerShell.Security."

The following statement requires the Windows PowerShell 2.0 version or
any later version of the Microsoft.PowerShell.Security snap-in:

#requires -PsSnapIn Microsoft.PowerShell.Security -Version 2

The following statement requires Windows PowerShell 2.0 or a later
version:

#requires -Version 2.0

The following script has two #Requires statements. The requirements
specified in both statements must be met. Otherwise, the script will not
run. Each #Requires statement must be the first item on a line:

#requires -PsSnapIn Microsoft.PowerShell.Security -Version 2
Get-WMIObject WIN32_LogicalDisk | out-file K:\status\DiskStatus.txt
#requires -Version 2

The following #Requires statement prevents a script from running if the
specified shell ID does not match the current shell ID. The current
shell ID is stored in the $ShellId variable:

#requires -ShellId MyLocalShell

SEE ALSO
about_Automatic_Variables
about_Language_Keywords
about_PSSnapins
get-PSSnapin

C:\Windows>powershell get-help about_Reserved_Words -full

ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.

OS: Windows 10, 8.1, 8, 7, Vista / Windows Server 2016, 2012, 2008
»»»» ColorConsole








Windows-10





Windows-10

... facebook.de
... Windows-10 FAQ
... Windows-10 Info


Become a Sponsor
... Your button here?





PowerShell: Prevents a script from running by requiring the specified snap-ins and

HTTP: ... PS_Windows/en/about_requires.htm
0.171
14034

Turn off Grouping in File Explorer!

 /

Windows 10 "System Recovery" + cmd features!

 /

Can I filter certain file types in the folder contents printing?

 /

Kaspersky Internet Security und Q-Dir langsamer Programmstart?

 /

Replace function with special character support!

 /

Why do some file/directory sizes have underline? I would like to turn off!

 /

Create a Windows 8 or 8.1 desktop shortcut for fast shutdown, log off, restart?

 /

Unterschied erweiterte Eingabeaufforderung und normal unter Windows?

 /

Download Windows Server 2012 R2 x64 and test it!

 /

Windows-Programme immer maximiert öffnen, wenn möglich mit Beispiel?

 /

Flugmodus bei Windows 10 deaktivieren?

 /

Where are the Auto Update settings in Windows 10 (enable / disable)?

 /