Invoke-ScriptAnalyzer

Modül:

PSScriptAnalyzer Module

Seçilen en iyi yöntem kurallarına göre bir betiği veya modülü değerlendirir

Sözdizimi

Path_SuppressedOnly EnterprisePublishing

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, en iyi yöntem kuralları koleksiyonuna göre betikleri veya modül dosyalarını (.ps1, .psm1ve .psd1 dosyaları) değerlendirir ve kural ihlallerini temsil eden nesneler döndürür. Ayrıca DSC kaynaklarını analiz etmek için özel kurallar içerir.

Invoke-ScriptAnalyzer bir dizi yerleşik kuralla birlikte gelir. Varsayılan olarak tüm kuralları kullanır. İstediğiniz kuralları seçmek için IncludeRule ve ExcludeRule parametrelerini kullanabilirsiniz. Get-ScriptAnalyzerRule cmdlet'ini kullanarak değerlendirmeye dahil etmek veya değerlendirmeden çıkarmak istediğiniz kuralları inceleyebilir ve seçebilirsiniz.

Ayrıca, PowerShell betiklerinde yazdığınız özelleştirilmiş kuralları kullanabilir veya C# kullanarak derlemelerde derleyebilirsiniz. IncludeRule ve ExcludeRule parametreleri özel kurallar da seçilebilir.

Analize bir kural da ekleyebilirsiniz, ancak seçili işlevler veya betikler için bu kuralın çıkışını gizleyebilirsiniz. Bu özellik yalnızca gerektiğinde kullanılmalıdır. Gizlenen kuralları almak için Invoke-ScriptAnalyzer parametresiyle çalıştırın.

CI sistemlerinde kullanım için EnableExit , hata kaydı sayısına eşit bir çıkış koduyla kabuktan çıkar.

Örnekler

ÖRNEK 1 - Betik üzerinde tüm Betik Çözümleyicisi kurallarını çalıştırma

Invoke-ScriptAnalyzer -Path C:\Scripts\Get-LogData.ps1

ÖRNEK 2 - Modules dizinindeki tüm dosyalarda tüm Betik Çözümleyicisi kurallarını çalıştırma

Bu örnek, kullanıcı tabanlı .ps1 dizininizdeki ve alt dizinlerindeki tüm .psm1 ve Modules dosyalarında tüm Betik Çözümleyicisi kurallarını çalıştırır.

Invoke-ScriptAnalyzer -Path $home\Documents\WindowsPowerShell\Modules -Recurse

ÖRNEK 3 - Modülde tek bir kural çalıştırma

Bu örnek, modül klasöründeki dosyalar üzerinde yalnızca PSDiagnostics kuralını çalıştırır. Belirli bir kural ihlalinin tüm örneklerini bulmak için bunun gibi bir komut kullanabilirsiniz.

Invoke-ScriptAnalyzer -Path C:\Windows\System32\WindowsPowerShell\v1.0\Modules\PSDiagnostics -IncludeRule PSAvoidUsingPositionalParameters

ÖRNEK 4 - Modüllerinizde iki kural dışında tüm kuralları çalıştırma

Bu örnek, PSAvoidUsingCmdletAliases ve PSAvoidUsingInternalURLs.ps1 ve .psm1 dizinindeki ve alt dizinlerindeki MyModules dosyaları dışındaki tüm kuralları çalıştırır.

Invoke-ScriptAnalyzer -Path C:\ps-test\MyModule -Recurse -ExcludeRule PSAvoidUsingCmdletAliases, PSAvoidUsingInternalURLs

ÖRNEK 5 - Betik Çözümleyicisi'ni özel kurallarla çalıştırma

Bu örnek, Test-Script.ps1 yolunda standart kurallar ve kurallarla C:\CommunityAnalyzerRules Betik Çözümleyicisi çalıştırır.

Invoke-ScriptAnalyzer -Path D:\test_scripts\Test-Script.ps1 -CustomRulePath C:\CommunityAnalyzerRules -IncludeDefaultRules

ÖRNEK 6 - Yalnızca Hata önem derecesi olan ve PSDSC kaynak adına sahip kuralları çalıştırın

$DSCError = Get-ScriptAnalyzerRule -Severity Error | Where SourceName -eq PSDSC
$Path = "$home\Documents\WindowsPowerShell\Modules\MyDSCModule"
Invoke-ScriptAnalyzerRule -Path $Path -IncludeRule $DSCError -Recurse

ÖRNEK 7 - Kural ihlallerini gizleme

Bu örnek, bir işlevdeki kural ihlallerinin bildirilmesinin nasıl gizlendiğini ve gizlenen kural ihlallerinin nasıl bulunduğunu gösterir.

Örnek, SuppressMessageAttribute betiğindeki işlevi için PSAvoidUsingCmdletAliases Get-Widgets engellemek için Get-Widgets.ps1 özniteliğini kullanır. Modül, betik, sınıf, işlev, parametre veya satır için bir kuralı engellemek için bu özniteliği kullanabilirsiniz.

İlk komut, işlevi içeren betik dosyasında Script Analyzer çalıştırır. Çıkış bir kural ihlali bildiriyor. Daha fazla kural ihlal edilmiş olsa da, gizlenen hiçbir kural bildirilir.

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

İkinci komut, gizlenen betik dosyası kurallarının ihlallerini bildirmek için SuppressedOnly parametresini kullanır.

ÖRNEK 8 - Profil tanımı kullanarak betik dosyalarını analiz etme

Bu örnekte, bir Betik Çözümleyicisi profili oluşturacak ve bunu geçerli dizindeki ScriptAnalyzerProfile.txt dosyasına kaydedeceğiz. Invoke-ScriptAnalyzer modülü dosyalarında çalıştırıyoruz. Profili parametresinin değeri, Betik Çözümleyicisi profilinin yoludur.

# In .\ScriptAnalyzerProfile.txt
@{
    Severity = @('Error', 'Warning')
    IncludeRules = 'PSAvoid*'
    ExcludeRules = '*WriteHost'
}

Invoke-ScriptAnalyzer -Path $pshome\Modules\BitLocker -Settings .\ScriptAnalyzerProfile.txt

Invoke-ScriptAnalyzer komutuna -Severity Errorgibi çakışan bir parametre eklerseniz, cmdlet profil değerini kullanır ve parametresini yoksayar.

ÖRNEK 9 - Dize olarak depolanan bir betiği analiz etme

Bu örnekte komut satırındaki bir işlevi analiz etmek için ScriptDefinition parametresi kullanılır. İşlev dizesi tırnak içine alınır.

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

ScriptDefinition parametresini kullandığınızda, DiagnosticRecord nesnesinin FileName özelliği $null.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Cf

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-CustomRulePath

Kuralları tanımlayan bir dosyanın yolunu veya kuralları tanımlayan dosyaları içeren bir dizin girin. Joker karakterler desteklenir. CustomRulePath belirtildiğinde, çözümleme için yalnızca belirtilen yollarda bulunan özel kurallar kullanılır. Invoke-ScriptAnalyzer içinde kuralları bulamazsa, standart kuralları önceden haber vermeden çalıştırır.

Yolun alt dizinlerinde tanımlanan kuralları eklemek için RecurseCustomRulePath parametresini kullanın. Yerleşik kuralları eklemek için IncludeDefaultRules parametresini ekleyin.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False
Diğer adlar:	ÖzelleştirilmişKural Yolu

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-EnableExit

Çözümleme tamamlandığında, bu parametre PowerShell oturumlarından çıkar ve hata kayıtlarının sayısına eşit bir çıkış kodu döndürür. Bu, sürekli tümleştirme (CI) işlem hattında yararlı olabilir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ExcludeRule

Betik Çözümleyicisi testinden belirtilen kuralları atlar. Joker karakterler desteklenir.

Virgülle ayrılmış bir kural adları listesi, kural adları içeren bir değişken veya kural adlarını alan bir komut girin. Betik Çözümleyicisi profil dosyasında dışlanan kuralların listesini de belirtebilirsiniz. Standart kuralları ve kuralları özel bir kural yolunda dışlayabilirsiniz.

Bir kuralı dışladığınızda, kural yoldaki dosyaların hiçbirinde çalışmaz. Belirli bir satır, parametre, işlev, betik veya sınıftaki bir kuralı dışlamak için Path parametresini ayarlayın veya kuralı gizleyin. Kuralı gizleme hakkında bilgi için örneklere bakın.

Bir kural hem ExcludeRule hem de IncludeRule koleksiyonları belirtilirse, kural dışlanır.

Parametre özellikleri

Tür:	String[]
Default value:	All rules are included.
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Fix

DiagnosticRecordiçinde düzeltme içeren bazı uyarıları düzeltir.

düzeltme kullandığınızda Invoke-ScriptAnalyzer çözümlemeyi çalıştırmadan önce düzeltmeleri uygular. Bu parametreyi kullanırken dosyalarınızın yedeğine sahip olduğunuzdan emin olun. Dosya kodlamasını korumaya çalışır, ancak yine de kodlamanın değişebileceği bazı durumlar vardır.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Path_SuppressedOnly

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

Path_IncludeSuppressed

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IncludeDefaultRules

Özel kurallarla birlikte varsayılan kuralları da çağır.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IncludeRule

Betik Çözümleyicisi testinde yalnızca belirtilen kuralları çalıştırır. Varsayılan olarak, PSScriptAnalyzer tüm kuralları çalıştırır.

Virgülle ayrılmış bir kural adları listesi, kural adları içeren bir değişken veya kural adlarını alan bir komut girin. Joker karakterler desteklenir. Kural adlarını bir Betik Çözümleyicisi profil dosyasında da belirtebilirsiniz.

CustomizedRulePath parametresini kullandığınızda, özel kural yollarına standart kuralları ve kuralları eklemek için bu parametreyi kullanabilirsiniz.

Bir kural hem ExcludeRule hem de IncludeRule koleksiyonları belirtilirse, kural dışlanır.

Önem Derecesi parametresi, IncludeRule'den önceliklidir. Örneğin, önem derecesi Error kuralı eklemek için includerule Warning kullanamazsınız.

Parametre özellikleri

Tür:	String[]
Default value:	All rules are included.
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IncludeSuppressed

Çıktıya gizlenen tanılamaları dahil edin.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Path_IncludeSuppressed

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

ScriptDefinition_IncludeSuppressed

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Path

Analiz edilecek betiklerin veya modülün yolunu belirtir. Joker karakterler desteklenir.

Betiğin (.ps1) veya modül dosyasının (.psm1) yolunu ya da betikler veya modüller içeren bir dizinin yolunu girin. Dizin başka dosya türleri içeriyorsa, bunlar yoksayılır.

Belirtilen yolun kök dizininde olmayan dosyaları çözümlemek için joker karakter (C:\Modules\MyModule\*) veya Yineleme parametresini kullanın.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False
Diğer adlar:	PSPath

Parametre kümeleri

Path_SuppressedOnly

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

Path_IncludeSuppressed

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Recurse

Path dizinindeki dosyalar ve tüm alt dizinlerde Betik Çözümleyicisi'ni yinelemeli olarak çalıştırır.

Özyineleme yalnızca Path parametresi değerine uygulanır. CustomRulePath yinelemeli olarak aramak için RecurseCustomRulePath parametresini kullanın.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RecurseCustomRulePath

CustomRulePath konumunun alt dizinlerinde tanımlanan kuralları ekler. Varsayılan olarak, Invoke-ScriptAnalyzer yalnızca belirtilen dosya veya dizinde tanımlanan özel kuralları kullanır. Yerleşik kuralları eklemek için IncludeDefaultRules parametresini kullanın.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ReportSummary

Konağa bulunan ihlallerin özetini yazın.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SaveDscDependency

DSC kaynak bağımlılıklarını çözün.

Invoke-ScriptAnalyzer bu parametreyle çalıştırıldığında, Import-DSCResource -ModuleName <somemodule>örneklerini arar. <somemodule>aranarak $env:PSModulePath bulunamazsa Invoke-ScriptAnalyzer ayrıştırma hatası döndürür. Bu hata, PowerShell ayrıştırıcısının <somemodule>simgesini bulamamasından kaynaklanır.

Invoke-ScriptAnalyzer modülü PowerShell Galerisi'nde bulursa eksik modülü geçici bir yola indirir. Daha sonra tarama süresi boyunca geçici yol $env:PSModulePath eklenir. Geçici konum $LOCALAPPDATA/PSScriptAnalyzer/TempModuleDirbulunabilir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ScriptDefinition

Çözümlemeyi bir dizedeki komutlar, işlevler veya ifadeler üzerinde çalıştırır. Deyimleri, ifadeleri ve işlevleri betik bağlamından bağımsız olarak analiz etmek için bu özelliği kullanabilirsiniz.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ScriptDefinition_IncludeSuppressed

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

ScriptDefinition_SuppressedOnly

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Settings

Kullanıcı tanımlı profil veya ScriptAnalyzer ayarlarını içeren bir karma tablo nesnesi içeren dosyanın yolu.

Invoke-ScriptAnalyzer dosya veya karma tablo içinde belirtilen parametreler ve değerlerle çalıştırır.

Dosya veya karma tablo yolu veya içeriği geçersizse, yoksayılır. Profildeki parametreler ve değerler, komut satırında belirtilen aynı parametre ve değerlerden önceliklidir.

Betik Çözümleyicisi profil dosyası, aşağıdaki anahtarlardan birine veya daha fazlasına sahip bir karma tablo içeren bir metin dosyasıdır:

• CustomRulePath
• ExcludeRules
• IncludeDefaultRules
• IncludeRules
• RecurseCustomRulePath
• Kurallar
• Şiddet

Profildeki anahtarlar ve değerler, Invoke-ScriptAnalyzerstandart parametreleri ve değerleriymiş gibi yorumlanır. Daha fazla bilgi için bkz. about_Splatting.

Parametre özellikleri

Tür:	Object
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Profil

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Severity

Betik Çözümleyicisi tüm kurallarla çalıştırıldıktan sonra, bu parametre belirtilen önem derecesine sahip kural ihlallerini seçer.

Geçerli değerler şunlardır:

• Hata
• Uyarı
• Bilgi.

Bir veya daha fazla önem derecesi değeri belirtebilirsiniz.

parametresi yalnızca tüm kuralları çalıştırdıktan sonra kural ihlallerini filtreler. Kuralları verimli bir şekilde filtrelemek için Get-ScriptAnalyzerRule kullanarak çalıştırmak istediğiniz kuralları seçin.

Önem Derecesi parametresi, IncludeRule'den önceliklidir. Örneğin, önem derecesi Error kuralı eklemek için includerule Warning kullanamazsınız.

Parametre özellikleri

Tür:	String[]
Default value:	All rule violations
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SuppressedOnly

Yalnızca gizlenen kurallar için ihlalleri döndürür.

SuppressedRecord nesnesi döndürür (Microsoft.Windows.PowerShell.ScriptAnalyzer.Generic.SuppressedRecord).

Bir kuralı engellemek için suppressMessageAttribute kullanın. Yardım için örneklere bakın.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Path_SuppressedOnly

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

ScriptDefinition_SuppressedOnly

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Wi

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Bu cmdlet'e giriş kanalı yapamazsınız.

Çıkışlar

Microsoft.Windows.PowerShell.ScriptAnalyzer.Generic.DiagnosticRecord

Varsayılan olarak, Invoke-ScriptAnalyzer her kural ihlali için bir DiagnosticRecord nesnesi döndürür.

Microsoft.Windows.PowerShell.ScriptAnalyzer.Generic.SuppressedRecord

SuppressedOnly parametresini kullanırsanız Invoke-ScriptAnalyzer bunun yerine SuppressedRecord nesneleri döndürür.

İlişkili Bağlantılar

• Get-ScriptAnalyzerRule
• GitHub'da PSScriptAnalyzer