Sdílet prostřednictvím

Set-StrictMode

Modul:
Microsoft.PowerShell.Core Module

Vytvoří a vynucuje pravidla kódování ve výrazech, skriptech a blocích skriptů.

Syntax

Version (Výchozí) 

Set-StrictMode
    -Version <Version>
    [<CommonParameters>]

Off 

Set-StrictMode
    [-Off]
    [<CommonParameters>]

Description

Rutina Set-StrictMode konfiguruje striktní režim pro aktuální obor a všechny podřízené obory a zapne a vypne. Pokud je zapnutý striktní režim, PowerShell vygeneruje ukončující chybu, když obsah výrazu, skriptu nebo bloku skriptu porušuje základní pravidla kódování osvědčených postupů.

Pomocí parametru Version určete pravidla kódování, která se mají vynutit.

Set-PSDebug -Strict rutina zapne striktní režim pro globální obor. Set-StrictMode ovlivňuje pouze aktuální obor a jeho podřízené obory. Pak ho můžete použít ve skriptu nebo funkci k přepsání nastavení zděděného z globálního oboru.

Když je Set-StrictMode vypnutý, Má PowerShell následující chování:

  • Neinicializované proměnné se předpokládají, že mají v závislosti na typu hodnotu 0 (nula) nebo $Null.
  • Odkazy na neexistující vlastnosti vrací $Null
  • Výsledky nesprávné syntaxe funkce se liší podle chybových podmínek.
  • Pokus o načtení hodnoty pomocí neplatného indexu v poli vrátí $Null

Příklady

Příklad 1: Zapnutí přísného režimu ve verzi 1.0

# Strict mode is off by default.
$a -gt 5

False

Set-StrictMode -Version 1.0
$a -gt 5

InvalidOperation: The variable '$a' cannot be retrieved because it has not been set.

Při nastavení striktního režimu na verzi 1.0se pokusy o odkazování na proměnné, které nejsou inicializovány, nezdaří.

Příklad 2: Zapnutí přísného režimu ve verzi 2.0

# Strict mode is off by default.
function add ($a, $b) {
    '$a = ' + $a
    '$b = ' + $b
    '$a+$b = ' + ($a + $b)
}
add 3 4

$a = 3
$b = 4
$a+$b = 7

add(3,4)

$a = 3 4
$b =
$a+$b = 3 4

Set-StrictMode -Version 2.0
add(3,4)

InvalidOperation: The function or command was called as if it were a method. Parameters should be separated by spaces. For information about parameters, see the about_Parameters Help topic.

Set-StrictMode -Off
$string = "This is a string."
$null -eq $string.Month

True

Set-StrictMode -Version 2.0
$string = "This is a string."
$null -eq $string.Month

PropertyNotFoundException: The property 'Month' cannot be found on this object. Verify that the property exists.

Tento příkaz zapne striktní režim a nastaví ho na verzi 2.0. V důsledku toho PowerShell vrátí chybu, pokud použijete syntaxi metody, která používá závorky a čárky, pro volání funkce nebo odkazování na neinicializované proměnné nebo neexistující vlastnosti.

Ukázkový výstup ukazuje účinek verze 2.0 striktní režim.

Bez verze 2.0 striktní režim se hodnota (3,4) interpretuje jako jeden maticový objekt, ke kterému se nic nečte přidat. U verze 2.0 striktní režim se správně interpretuje jako chybná syntaxe pro odesílání dvou hodnot.

Bez 2.0verze vrátí odkaz na neexistující vlastnost Měsíc řetězce pouze $Null. U 2.0verze se správně interpretuje jako referenční chyba.

Příklad 3: Zapnutí přísného režimu ve verzi 3.0

S přísným režimem nastaveným na Vypnuto, neplatné nebo mimo indexy vrátí hodnoty null.

# Strict mode is off by default.
$a = @(1)
$null -eq $a[2]
$null -eq $a['abc']

True
True

Set-StrictMode -Version 3.0
$a = @(1)
$null -eq $a[2]
$null -eq $a['abc']

OperationStopped: Index was outside the bounds of the array.

InvalidArgument: Cannot convert value "abc" to type "System.Int32". Error: "Input string was not in a correct format."

Při použití přísného režimu nastaveného na verzi 3 nebo vyšší může dojít k chybám neplatných indexů nebo indexů, které jsou mimo hranice.

Parametry

-Off

Označuje, že tato rutina vypne striktní režim pro aktuální obor a všechny podřízené obory.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Off
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Version

Určuje podmínky, které způsobují chybu v přísném režimu. Tento parametr přijímá jakékoli platné číslo verze PowerShellu. Jakékoli číslo vyšší než 3 se považuje za Latest. Zadaná hodnota musí být řetězec Latest nebo řetězec, který lze převést na typ System.Version. Verze musí odpovídat platné verzi PowerShellu.

Platné hodnoty pro tento parametr jsou:

  • 1.0
    • Zakáže odkazy na neinicializované proměnné s výjimkou neinicializovaných proměnných v řetězcích.
  • 2.0
    • Zakáže odkazy na neinicializované proměnné. To zahrnuje neinicializované proměnné v řetězcích.
    • Zakáže odkazy na neexistující vlastnosti objektu.
    • Zakáže volání funkcí, která používají syntaxi pro volání metod.
  • 3.0
    • Zakáže odkazy na neinicializované proměnné. To zahrnuje neinicializované proměnné v řetězcích.
    • Zakáže odkazy na neexistující vlastnosti objektu.
    • Zakáže volání funkcí, která používají syntaxi pro volání metod.
    • Zakázat mimo hranice nebo nerozpoznané indexy pole.
  • Latest
    • Vybere nejnovější dostupnou verzi. Nejnovější verze je nejtriktnější. Pomocí této hodnoty se ujistěte, že skripty používají nejskutečnější dostupnou verzi, i když se do PowerShellu přidají nové verze.

Upozornění

Použití Latest pro verze ve skriptech není deterministické. Význam Latest se může změnit v nových verzích PowerShellu. Skript napsaný pro starší verzi PowerShellu, která používá Set-StrictMode -Version Latest, podléhá více omezujícím pravidlům při spuštění v novější verzi PowerShellu.

Vlastnosti parametru

Typ:Version
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:v

Sady parametrů

Version
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Do tohoto cmdletu nemůžete předávat objekty.

Výstupy

None

Tento cmdlet nevrátí žádný výstup.

Poznámky

Zatímco Version parametr přijímá hodnoty větší než 3.0, neexistují žádná další pravidla definovaná pro cokoli vyššího než 3.0.

Set-StrictMode je efektivní pouze v rozsahu, ve který je nastavený a v podřízených oborech. Další informace o oborech v PowerShellu najdete v tématu about_Scopes.