Invoke-ScriptAnalyzer
Vyhodnotí skript nebo modul na základě vybraných pravidel osvědčených postupů.
Syntax
Path_SuppressedOnly (Výchozí)
Invoke-ScriptAnalyzer
[-Path] <string>
[-CustomRulePath <string[]>]
[-RecurseCustomRulePath]
[-IncludeDefaultRules]
[-ExcludeRule <string[]>]
[-IncludeRule <string[]>]
[-Severity <string[]>]
[-Recurse]
[-SuppressedOnly]
[-Fix]
[-EnableExit]
[-Settings <Object>]
[-SaveDscDependency]
[-ReportSummary]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Path_IncludeSuppressed
Invoke-ScriptAnalyzer
[-Path] <string>
-IncludeSuppressed
[-CustomRulePath <string[]>]
[-RecurseCustomRulePath]
[-IncludeDefaultRules]
[-ExcludeRule <string[]>]
[-IncludeRule <string[]>]
[-Severity <string[]>]
[-Recurse]
[-Fix]
[-EnableExit]
[-Settings <Object>]
[-SaveDscDependency]
[-ReportSummary]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ScriptDefinition_IncludeSuppressed
Invoke-ScriptAnalyzer
[-ScriptDefinition] <string>
-IncludeSuppressed
[-CustomRulePath <string[]>]
[-RecurseCustomRulePath]
[-IncludeDefaultRules]
[-ExcludeRule <string[]>]
[-IncludeRule <string[]>]
[-Severity <string[]>]
[-Recurse]
[-EnableExit]
[-Settings <Object>]
[-SaveDscDependency]
[-ReportSummary]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ScriptDefinition_SuppressedOnly
Invoke-ScriptAnalyzer
[-ScriptDefinition] <string>
[-CustomRulePath <string[]>]
[-RecurseCustomRulePath]
[-IncludeDefaultRules]
[-ExcludeRule <string[]>]
[-IncludeRule <string[]>]
[-Severity <string[]>]
[-Recurse]
[-SuppressedOnly]
[-EnableExit]
[-Settings <Object>]
[-SaveDscDependency]
[-ReportSummary]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Invoke-ScriptAnalyzer vyhodnocuje skripty nebo soubory modulů (.ps1, .psm1a soubory .psd1) na základě kolekce pravidel osvědčených postupů a vrací objekty, které představují porušení pravidel. Obsahuje také speciální pravidla pro analýzu prostředků DSC.
Invoke-ScriptAnalyzer obsahuje sadu předdefinovaných pravidel. Ve výchozím nastavení používá všechna pravidla. K výběru požadovaných pravidel můžete použít IncludeRule a ExcludeRule parametry. Pomocí rutiny Get-ScriptAnalyzerRule můžete zkontrolovat a vybrat pravidla, která chcete zahrnout nebo vyloučit z vyhodnocení.
Můžete také použít přizpůsobená pravidla, která píšete ve skriptech PowerShellu, nebo kompilovat v sestaveních pomocí jazyka C#. Vlastní pravidla je také možné vybrat pomocí parametrů IncludeRule a ExcludeRu le.
Do analýzy můžete také zahrnout pravidlo, ale potlačit výstup tohoto pravidla pro vybrané funkce nebo skripty. Tato funkce by se měla používat pouze v případě potřeby. Pokud chcete získat potlačená pravidla, spusťte Invoke-ScriptAnalyzer s parametrem SuppressedOnly.
Pro použití v systémech CI EnableExit ukončí prostředí s ukončovacím kódem, který se rovná počtu chybových záznamů.
Příklady
PŘÍKLAD 1 – Spuštění všech pravidel Analyzátoru skriptů ve skriptu
Invoke-ScriptAnalyzer -Path C:\Scripts\Get-LogData.ps1
PŘÍKLAD 2 – Spuštění všech pravidel Analyzátoru skriptů pro všechny soubory v adresáři Moduly
Tento příklad spustí všechna pravidla Analyzátoru skriptů na všech .ps1 a .psm1 souborech v adresáři Modules založeném na uživatelích a jeho podadresářích.
Invoke-ScriptAnalyzer -Path $home\Documents\WindowsPowerShell\Modules -Recurse
PŘÍKLAD 3 – Spuštění jednoho pravidla v modulu
Tento příklad spustí pouze pravidlo PSAvoidUsingPositionalParameters pro soubory ve složce modulu PSDiagnostics. K vyhledání všech instancí porušení konkrétního pravidla můžete použít podobný příkaz.
Invoke-ScriptAnalyzer -Path C:\Windows\System32\WindowsPowerShell\v1.0\Modules\PSDiagnostics -IncludeRule PSAvoidUsingPositionalParameters
PŘÍKLAD 4 – Spuštění všech pravidel s výjimkou dvou v modulech
Tento příklad spustí všechna pravidla s výjimkou PSAvoidUsingCmdletAliases a PSAvoidUsingInternalURLs na .ps1 a .psm1 soubory v adresáři MyModules a v jeho podadresářích.
Invoke-ScriptAnalyzer -Path C:\ps-test\MyModule -Recurse -ExcludeRule PSAvoidUsingCmdletAliases, PSAvoidUsingInternalURLs
PŘÍKLAD 5 – Spuštění analyzátoru skriptů s vlastními pravidly
Tento příklad spustí Analyzátor skriptů na Test-Script.ps1 se standardními pravidly a pravidly v cestě C:\CommunityAnalyzerRules.
Invoke-ScriptAnalyzer -Path D:\test_scripts\Test-Script.ps1 -CustomRulePath C:\CommunityAnalyzerRules -IncludeDefaultRules
PŘÍKLAD 6 – Spusťte pouze pravidla, která mají závažnost chyby a mají název zdroje PSDSC.
$DSCError = Get-ScriptAnalyzerRule -Severity Error | Where SourceName -eq PSDSC
$Path = "$home\Documents\WindowsPowerShell\Modules\MyDSCModule"
Invoke-ScriptAnalyzerRule -Path $Path -IncludeRule $DSCError -Recurse
PŘÍKLAD 7 – Potlačení porušení pravidel
Tento příklad ukazuje, jak potlačit hlášení porušení pravidel ve funkci a jak zjistit porušení pravidel, která jsou potlačena.
Příklad používá atribut SuppressMessageAttribute k potlačení PSUseSingularNouns a PSAvoidUsingCmdletAliases pravidla pro funkci Get-Widgets ve skriptu Get-Widgets.ps1.
Tento atribut můžete použít k potlačení pravidla pro modul, skript, třídu, funkci, parametr nebo řádek.
První příkaz spustí Analyzátor skriptů v souboru skriptu obsahujícím funkci. Výstup hlásí porušení pravidla. I když jsou porušena další pravidla, nenahlásí se ani potlačené pravidlo.
function Get-Widgets
{
[CmdletBinding()]
[System.Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "")]
[System.Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidUsingCmdletAliases", "", Justification="Resolution in progress.")]
Param()
dir $pshome
...
}
Invoke-ScriptAnalyzer -Path .\Get-Widgets.ps1
RuleName Severity FileName Line Message
-------- -------- -------- ---- -------
PSProvideCommentHelp Information ManageProf 14 The cmdlet 'Get-Widget' does not have a help comment.
iles.psm1
Invoke-ScriptAnalyzer -Path .\Get-Widgets.ps1 -SuppressedOnly
Rule Name Severity File Name Line Justification
--------- -------- --------- ---- -------------
PSAvoidUsingCmdletAliases Warning ManageProf 21 Resolution in progress.
iles.psm1
PSUseSingularNouns Warning ManageProf 14
iles.psm1
Druhý příkaz používá parametr SuppressedOnly k hlášení porušení pravidel potlačeného souboru skriptu.
PŘÍKLAD 8 – Analýza souborů skriptu pomocí definice profilu
V tomto příkladu vytvoříme profil Analyzátoru skriptů a uložíme ho do souboru ScriptAnalyzerProfile.txt v aktuálním adresáři. Na souborech modulu Invoke-ScriptAnalyzer spustíme . Hodnota parametru Profile je cesta k profilu Analyzátoru skriptů.
# In .\ScriptAnalyzerProfile.txt
@{
Severity = @('Error', 'Warning')
IncludeRules = 'PSAvoid*'
ExcludeRules = '*WriteHost'
}
Invoke-ScriptAnalyzer -Path $pshome\Modules\BitLocker -Settings .\ScriptAnalyzerProfile.txt
Pokud do příkazu Invoke-ScriptAnalyzer zahrnete konfliktní parametr, například -Severity Error, použije rutina hodnotu profilu a parametr ignoruje.
PŘÍKLAD 9 – Analýza skriptu uloženého jako řetězec
Tento příklad používá parametr ScriptDefinition k analýze funkce na příkazovém řádku. Řetězec funkce je uzavřený v uvozovkách.
Invoke-ScriptAnalyzer -ScriptDefinition "function Get-Widgets {Write-Host 'Hello'}"
RuleName Severity FileName Line Message
-------- -------- -------- ---- -------
PSAvoidUsingWriteHost Warning 1 Script
because
there i
suppres
Write-O
PSUseSingularNouns Warning 1 The cmd
noun sh
Při použití ScriptDefinition parametr, FileName vlastnost DiagnosticRecord objektu je $null.
Parametry
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-CustomRulePath
Zadejte cestu k souboru, který definuje pravidla nebo adresář obsahující soubory, které definují pravidla.
Zástupné znaky jsou podporovány. Pokud je zadán CustomRulePath, pro analýzu se použijí pouze vlastní pravidla nalezená v zadaných cestách. Pokud Invoke-ScriptAnalyzer nemůže najít pravidla, spustí standardní pravidla bez předchozího upozornění.
Chcete-li přidat pravidla definovaná v podadresářích cesty, použijte parametr RecurseCustomRulePath. Pokud chcete zahrnout předdefinovaná pravidla, přidejte parametr IncludeDefaultRules.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
| Aliasy: | Přizpůsobená_cesta pravidel |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-EnableExit
Po dokončení analýzy tento parametr ukončí relace PowerShellu a vrátí ukončovací kód, který se rovná počtu záznamů chyb. To může být užitečné v kanálu kontinuální integrace (CI).
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ExcludeRule
Vynechá zadaná pravidla z testu Analyzátoru skriptů. Zástupné znaky jsou podporovány.
Zadejte čárkami oddělený seznam názvů pravidel, proměnnou obsahující názvy pravidel nebo příkaz, který získá názvy pravidel. Seznam vyloučených pravidel můžete také zadat v souboru profilu Analyzátoru skriptů. Ve vlastní cestě k pravidlu můžete vyloučit standardní pravidla a pravidla.
Když pravidlo vyloučíte, pravidlo se nespustí na žádném ze souborů v cestě. Chcete-li vyloučit pravidlo na konkrétním řádku, parametru, funkci, skriptu nebo třídě, upravte parametr Path nebo potlačit pravidlo. Informace o potlačení pravidla najdete v příkladech.
Pokud je pravidlo zadáno v ExcludeRule i IncludeRule kolekce, pravidlo je vyloučeno.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | All rules are included. |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Fix
Opravuje určitá upozornění, která obsahují opravu v jejich DiagnostickéZáznamy.
Pokud jste použili Fix, Invoke-ScriptAnalyzer tyto opravy použije před spuštěním analýzy. Při použití tohoto parametru se ujistěte, že máte zálohu souborů. Snaží se zachovat kódování souborů, ale stále existují případy, kdy se kódování může změnit.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Path_SuppressedOnly
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
Path_IncludeSuppressed
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-IncludeDefaultRules
Vyvolání výchozích pravidel spolu s vlastními pravidly
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-IncludeRule
Spustí pouze zadaná pravidla v testu Analyzátoru skriptů. Ve výchozím nastavení psScriptAnalyzer spouští všechna pravidla.
Zadejte čárkami oddělený seznam názvů pravidel, proměnnou obsahující názvy pravidel nebo příkaz, který získá názvy pravidel. Zástupné znaky jsou podporovány. Do souboru profilu Analyzátoru skriptů můžete také zadat názvy pravidel.
Pokud použijete parametr CustomizedRulePath, můžete tento parametr použít k zahrnutí standardních pravidel a pravidel do cest k vlastním pravidlům.
Pokud je pravidlo zadáno v ExcludeRule i IncludeRule kolekce, pravidlo je vyloučeno.
Parametr závažnosti má přednost před includeRule. Pokud je například závažnosti Error, nemůžete k zahrnutí pravidla použít Warning.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | All rules are included. |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-IncludeSuppressed
Zahrnout do výstupu potlačenou diagnostiku.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Path_IncludeSuppressed
| 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 |
ScriptDefinition_IncludeSuppressed
| 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 |
-Path
Určuje cestu ke skriptům nebo modulu, které se mají analyzovat. Zástupné znaky jsou podporovány.
Zadejte cestu ke skriptu (.ps1) nebo souboru modulu (.psm1) nebo k adresáři, který obsahuje skripty nebo moduly. Pokud adresář obsahuje jiné typy souborů, budou ignorovány.
K analýze souborů, které nejsou v kořenovém adresáři zadané cesty, použijte zástupný znak (C:\Modules\MyModule\*) nebo parametr Recurse.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
Path_SuppressedOnly
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
Path_IncludeSuppressed
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Recurse
Spustí Analyzátor skriptů na souborech v adresáři Cesta a všechny podadresáře rekurzivně.
Funkce Recurse se vztahuje pouze na hodnotu parametru Path. Pokud chcete hledat CustomRulePath rekurzivně, použijte parametr RecurseCustomRulePath.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-RecurseCustomRulePath
Přidá pravidla definovaná v podadresářích CustomRulePath umístění. Ve výchozím nastavení Invoke-ScriptAnalyzer používá pouze vlastní pravidla definovaná v zadaném souboru nebo adresáři. Pokud chcete zahrnout předdefinovaná pravidla, použijte parametr IncludeDefaultRules.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ReportSummary
Napište souhrn porušení nalezených hostiteli.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-SaveDscDependency
Řešení závislostí prostředků DSC
Při spuštění Invoke-ScriptAnalyzer s tímto parametrem vyhledá instance Import-DSCResource -ModuleName <somemodule>. Pokud <somemodule> nelze najít vyhledáním $env:PSModulePath, Invoke-ScriptAnalyzer vrátí chybu analýzy. Tato chyba je způsobená nemožností analyzátoru PowerShellu najít symbol pro <somemodule>.
Pokud Invoke-ScriptAnalyzer modul najde v galerii Prostředí PowerShell, stáhne chybějící modul do dočasné cesty. Dočasná cesta se pak přidá do $env:PSModulePath po dobu trvání kontroly.
Dočasné umístění najdete v $LOCALAPPDATA/PSScriptAnalyzer/TempModuleDir.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ScriptDefinition
Spustí analýzu příkazů, funkcí nebo výrazů v řetězci. Pomocí této funkce můžete analyzovat příkazy, výrazy a funkce nezávisle na kontextu skriptu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ScriptDefinition_IncludeSuppressed
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
ScriptDefinition_SuppressedOnly
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Settings
Cesta k souboru obsahujícímu uživatelem definovaný profil nebo objekt hashtable obsahující nastavení pro ScriptAnalyzer.
Spustí Invoke-ScriptAnalyzer s parametry a hodnotami zadanými v souboru nebo hashtable.
Pokud je cesta nebo obsah souboru nebo hashovací tabulky neplatné, bude ignorován. Parametry a hodnoty v profilu mají přednost před stejným parametrem a hodnotami zadanými na příkazovém řádku.
Soubor profilu Analyzátoru skriptů je textový soubor, který obsahuje hashtable s jedním nebo několika následujícími klíči:
- CustomRulePath
- Vyloučit pravidla
- IncludeDefaultRules
- Zahrnout pravidla
- RecurseCustomRulePath
- Pravidla
- Závažnost
Klíče a hodnoty v profilu jsou interpretovány jako standardní parametry a hodnoty Invoke-ScriptAnalyzer, podobně jako splatting. Další informace naleznete v části s názvem about_Splatting.
Vlastnosti parametru
| Typ: | Object |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Profil |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Severity
Po spuštění Analyzátoru skriptů se všemi pravidly tento parametr vybere porušení pravidel se zadanou závažností.
Platné hodnoty jsou:
- Chyba
- Výstraha
- Informace.
Můžete zadat jednu nebo více hodnot závažnosti.
Parametr filtruje porušení pravidel až po spuštění všech pravidel. Pokud chcete pravidla efektivně filtrovat, použijte Get-ScriptAnalyzerRule k výběru pravidel, která chcete spustit.
Parametr závažnosti má přednost před includeRule. Pokud je například závažnosti Error, nemůžete k zahrnutí pravidla použít Warning.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | All rule violations |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-SuppressedOnly
Vrátí porušení pouze pro potlačená pravidla.
Vrátí objekt SuppressedRecord (Microsoft.Windows.PowerShell.ScriptAnalyzer.Generic.SuppressedRecord).
Chcete-li potlačit pravidlo, použijte SuppressMessageAttribute. Nápovědu najdete v příkladech.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Path_SuppressedOnly
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
ScriptDefinition_SuppressedOnly
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| 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
Vstup do této rutiny nelze převést.
Výstupy
Microsoft.Windows.PowerShell.ScriptAnalyzer.Generic.DiagnosticRecord
Ve výchozím nastavení Invoke-ScriptAnalyzer vrátí jeden DiagnostickýZáznam objekt pro každé porušení pravidla.
Microsoft.Windows.PowerShell.ScriptAnalyzer.Generic.SuppressedRecord
Pokud použijete parametr SuppressedOnly, Invoke-ScriptAnalyzer místo toho vrátí objekty SuppressedRec ord.