Ortak Parametreler Hakkında

Kısa açıklama

Herhangi bir cmdlet ile kullanılabilecek parametreleri açıklar.

Uzun açıklama

Ortak parametreler, herhangi bir cmdlet ile kullanabileceğiniz bir cmdlet parametreleri kümesidir. Bunlar, cmdlet geliştiricisi tarafından değil PowerShell tarafından uygulanır ve tüm cmdlet'ler tarafından otomatik olarak kullanılabilir.

Ortak parametreleri herhangi bir cmdlet ile kullanabilirsiniz, ancak bunların tüm cmdlet'ler üzerinde bir etkisi olmayabilir. Örneğin, bir cmdlet herhangi bir ayrıntılı çıkış oluşturmazsa, ortak Verbose parametresinin kullanılmasının hiçbir etkisi yoktur.

Ortak parametreler, CmdletBinding özniteliğini veya Parameter özniteliğini kullanan gelişmiş işlevlerde de kullanılabilir. Bu öznitelikleri kullandığınızda PowerShell, Ortak Parametreleri otomatik olarak ekler. Common Parameters ile aynı adları kullanan hiçbir parametre oluşturamazsınız.

Çeşitli yaygın parametreler, PowerShell tercih değişkenlerini kullanarak ayarladığınız sistem varsayılanlarını veya tercihlerini geçersiz kılar. Tercih değişkenlerinden farklı olarak, ortak parametreler yalnızca kullanıldıkları komutları etkiler.

Daha fazla bilgi için bkz. about_Preference_Variables.

Aşağıdaki listede ortak parametreler görüntülenir. Diğer adları parantez içinde listelenir.

Debug (db)
ErrorAction (ea)
ErrorVariable (ev)
InformationAction (infa)
InformationVariable (iv)
OutVariable (ov)
OutBuffer (ob)
PipelineVariable (pv)
ProgressAction (proga)
Verbose (vb)
WarningAction (wa)
WarningVariable (wv)

Eylem parametreleri tür değerleridirActionPreference. ActionPreference aşağıdaki değerlere sahip bir numaralandırmadır:

Ad	Değer
`Break`	6
`Suspend`	5
`Ignore`	4
`Inquire`	3
`Continue`	2
`Stop`	1
`SilentlyContinue`	0

adı veya değeri parametresiyle kullanabilirsiniz.

Ortak parametrelere ek olarak, birçok cmdlet risk azaltma parametreleri sunar. Sistem veya kullanıcı verileri için risk içeren cmdlet'ler genellikle bu parametreleri sunar.

Risk azaltma parametreleri şunlardır:

WhatIf (wi)
Confirm (bkz)

Ortak parametreler

-Debug

komutu tarafından yapılan işlemle ilgili programcı düzeyindeki ayrıntıları görüntüler. Bu parametre yalnızca komut hata ayıklama iletisi oluşturduğunda çalışır. Örneğin, bir komut Write-Debug cmdlet'ini içerdiğinde bu parametre çalışır.

Type: SwitchParameter
Aliases: db
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Varsayılan olarak, değişkenin değeri $DebugPreference olduğundan SilentlyContinuehata ayıklama iletileri görüntülenmez.

Debug parametresi geçerli komut için değişkenin $DebugPreference değerini geçersiz kılar ve değerini $DebugPreference olarak Continueayarlar.

-Debug:$true, -Debugile aynı etkiye sahiptir. Hata ayıklama iletilerinin görüntülenme biçimini varsayılan değer değilken -Debug:$false$DebugPreferenceengellemek için kullanınSilentlyContinue.

-ErrorAction

cmdlet'in komuttan sonlandırılmayan bir hataya nasıl yanıt vereceğini belirler. Bu parametre, komutu veya cmdlet'i tarafından oluşturulan sonlandırılmayan hatalar için değişkenin Write-Error değerini $ErrorActionPreference geçersiz kılar.

Type: ActionPreference
Aliases: ea
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

ErrorAction parametresi geçerli komut için $ErrorActionPreference değişkeninin değerini geçersiz kılar. değişkeninin varsayılan değeri $ErrorActionPreference olduğundan Continue, parametresini kullanmadığınız ErrorAction sürece hata iletileri görüntülenir ve yürütme devam eder.

parametresi, -ErrorAction deyim sonlandırma hatalarının (eksik veriler, geçerli olmayan parametreler veya yetersiz izinler gibi) geçerli deyimi durdurmasını engellemez. Ancak, olarak Stopayarlandığında, sonlandırılmayan hataları betik sonlandırıcı hatalara yükselterek tarafından try/catchyakalanabilir hale gelir. Hata kategorileri hakkında daha fazla bilgi için bkz. about_Error_Handling.

Break Hata oluştuğunda veya özel durum oluştuğunda hata ayıklayıcıyı girer.
Continue hata iletisini görüntüler ve komutu yürütmeye devam eder. Continue varsayılan değerdir.
Ignore hata iletisini gizler ve komutu yürütmeye devam eder. Ignore'nin aksineSilentlyContinue, otomatik değişkene sonlandırılmayan $Error hatayı eklemez. Ignore Değeri PowerShell 3.0'da kullanıma sunulmuştur.
Inquire hata iletisini görüntüler ve yürütmeye devam etmeden önce sizden onay ister. Bu değer nadiren kullanılır.
SilentlyContinue hata iletisini gizler ve komutu yürütmeye devam eder.
Stop hata iletisini görüntüler ve komutu yürütmeyi durdurur. değeri, Stop bir oluşturarak sonlandırılmayan hatayı sonlandırıcı bir ActionPreferenceStopExceptionhataya yükseltir. Hata daha sonra bir try/catch blok veya trap deyim tarafından yakalanabilir.
Suspend yalnızca PowerShell 6 ve sonrasında desteklenmeyen iş akışları için kullanılabilir.

Not

ErrorAction Parametresi geçersiz kılar, ancak parametre komutta bir betik veya işlev çalıştırmak için kullanıldığında değişkenin $ErrorActionPreference değerini değiştirmez.

-ErrorVariable

Hata kayıtları otomatik olarak $Error otomatik değişkeninde depolanır. Daha fazla bilgi için bkz. about_Automatic_Variables.

Bir komutta parametresini ErrorVariable kullandığınızda, PowerShell komutu tarafından yayılan hata kayıtlarını parametresi tarafından belirtilen değişkende de depolar.

Type: String
Aliases: ev
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Varsayılan olarak, yeni hata iletileri zaten değişkende depolanan hata iletilerinin üzerine yazar. Hata iletisini değişken içeriğine eklemek için, değişken adının önüne bir artı işareti (+) koyun.

Örneğin, aşağıdaki komut $a değişkenini oluşturur ve hataları içinde depolar:

Get-Process -Id 6 -ErrorVariable a

Aşağıdaki komut $a değişkenine hata iletileri ekler:

Get-Process -Id 2 -ErrorVariable +a

Aşağıdaki komut $aiçeriğini görüntüler:

$a

Bu parametreyi yalnızca belirli komutlardan gelen hata iletilerini içeren ve $Error otomatik değişkenin davranışını etkilemeyen bir değişken oluşturmak için kullanabilirsiniz. $Error otomatik değişkeni, oturumdaki tüm komutlardan gelen hata iletilerini içerir. Değişkenlerde depolanan belirli hatalara başvurmak için $a[0] veya $Error[1,2] gibi dizi gösterimini kullanabilirsiniz.

Not

Özel hata değişkeni, iç içe işlevlere veya betiklere yapılan çağrılar dahil olmak üzere komut tarafından oluşturulan tüm hataları içerir.

-InformationAction

PowerShell 5.0'da kullanıma sunulmuştur. Kullanıldığı komut veya betik içinde, InformationAction ortak parametre varsayılan olarak olarak olarak ayarlanmış $InformationPreferenceolan tercih değişkeninin SilentlyContinue değerini geçersiz kılar. ile Write-InformationInformationAction bir betikte kullandığınızdaWrite-Information, parametresinin InformationAction değerine bağlı olarak değerler gösterilir. hakkında $InformationPreferencedaha fazla bilgi için bkz. about_Preference_Variables.

Type: ActionPreference
Aliases: infa
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

Break hata ayıklayıcıyı Write-Information komutunun bir örneğinde girer.
Stop, Write-Information komutunun oluşumunda bir komutu veya betiği durdurur.
Ignore bilgilendirme iletisini gizler ve komutu çalıştırmaya devam eder. ' SilentlyContinue den farklı olarakIgnore, bilgilendiren iletiyi tamamen unutur; bilgi akışını bilgilendiren iletiyi eklemez.
Inquire, Write-Information komutunda belirttiğiniz bilgilendirme iletisini görüntüler ve devam etmek isteyip istemediğinizi sorar.
Continue bilgilendirme iletisini görüntüler ve çalışmaya devam eder.
Suspend PowerShell 6 ve üzeri sürümlerde desteklenmez çünkü yalnızca iş akışları için kullanılabilir.
SilentlyContinue bilgilendirme iletisi (Varsayılan) görüntülenmediğinden ve betik kesintisiz devam ettiğinden hiçbir etkisi olmaz.

Not

InformationAction Parametre, komutta betik veya işlev çalıştırmak için kullanıldığında parametresi geçersiz kılar, ancak tercih değişkeninin değerini $InformationAction değiştirmez.

-InformationVariable

PowerShell 5.0'da kullanıma sunulmuştur. Ortak parametresini InformationVariable kullandığınızda, bilgi kayıtları parametresi tarafından belirtilen değişkende depolanır. PowerShell cmdlet'i de akışa Information bilgi kayıtları yazabilir. Bilgi kayıtlarını yazmak için Write-Information cmdlet'ini de kullanabilirsiniz.

Bilgi kayıtları varsayılan olarak konsolda ileti olarak görüntülenir. Ortak parametresini kullanarak bilgi kaydının görüntülenmesini InformationAction denetleyebilirsiniz. Ayrıca, $InformationPreference tercih değişkenini kullanarak davranışı değiştirebilirsiniz. hakkında $InformationPreferencedaha fazla bilgi için bkz. about_Preference_Variables.

Not

Bilgi değişkeni, iç içe işlevlere veya betiklere yapılan çağrılardan gelen bilgi iletileri de dahil olmak üzere komut tarafından oluşturulan tüm bilgi iletilerini içerir.

Type: String
Aliases: iv
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Varsayılan olarak, yeni bilgi kaydı değişkende zaten depolanmış olan değerlerin üzerine yazar. Hata iletisini değişken içeriğine eklemek için, değişken adının önüne bir artı işareti (+) koyun.

-OutBuffer

İşlem hattı üzerinden herhangi bir nesne gönderilmeden önce arabellekte birikecek nesne sayısını belirler. Bu parametreyi atlarsanız, nesneler oluşturuldukları sırada gönderilir.

Type: Int32
Aliases: ob
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Bu kaynak yönetimi parametresi ileri düzey kullanıcılar için tasarlanmıştır. Bu parametreyi kullandığınızda PowerShell, OutBuffer + 1toplu olarak sonraki cmdlet'e veri gönderir.

Aşağıdaki örnek, ForEach-Object cmdlet'ini kullanan Write-Host işlem blokları arasında görüntülenir. Görüntü, 2 veya OutBuffer + 1toplu olarak değiştirilir.

1..4 | ForEach-Object {
        Write-Host "$($_): First"; $_
      } -OutBuffer 1 | ForEach-Object {
                        Write-Host "$($_): Second" }

1: First
2: First
1: Second
2: Second
3: First
4: First
3: Second
4: Second

-OutVariable

komuttaki çıkış nesnelerini, çıkışı işlem hattı boyunca göndermeye ek olarak belirtilen değişkende depolar.

Type: String
Aliases: ov
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Çıktıyı değişkenine eklemek için, orada depolanmış olabilecek herhangi bir çıkışı değiştirmek yerine, değişken adından önce bir artı işareti (+) yazın.

Örneğin, aşağıdaki komut $out değişkenini oluşturur ve işlem nesnesini içinde depolar:

Get-Process powershell -OutVariable out

Aşağıdaki komut, işlem nesnesini $out değişkenine ekler:

Get-Process iexplore -OutVariable +out

Aşağıdaki komut $out değişkeninin içeriğini görüntüler:

$out

Not

parametresi tarafından OutVariable oluşturulan değişken bir [System.Collections.ArrayList]'dir.

-PipelineVariable

PipelineVariable , bu parametreyi kullanan komut tarafından bir sonraki işlem hattı kesimine geçirilen en son değere erişime izin verir. İşlem hattındaki herhangi bir komut adlı PipelineVariablekomutunu kullanarak değere erişebilir. Değer, bir sonraki işlem hattı kesimine geçirildiğinde değişkene atanır. Bu, birden çok konuma atanılması gerekebilecek belirli bir geçici değişkenden daha kolay kullanılmasını sağlar PipelineVariable .

veya $_'den farklı $PSItem olarak, bir kullanarak herhangi bir PipelineVariable işlem hattı komutunun hemen önceki komut dışındaki komutlar tarafından geçirilen (ve kaydedilen) işlem hattı değerlerine erişmesine izin verir. İşlem hattı komutları, işlem hattından geçen sonraki öğeyi işlerken gelen son değere erişebilir. Bu, komutun çıkışını önceki bir komuta (veya kendisine) döndürmesine olanak tanır.

Not

Gelişmiş işlevlerin en fazla üç betik bloğu olabilir: begin, processve end. gelişmiş işlevlerle parametresi kullanılırken PipelineVariable , işlev çalıştırılırken değişkene yalnızca ilk tanımlı betik bloğundan değerler atanır. Daha fazla bilgi için bkz . Gelişmiş işlevler. PowerShell 7.2 bu davranışı düzeltmektedir.

Type: String
Aliases: pv
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Geçerli değerler, herhangi bir değişken adıyla aynı olan dizelerdir.

Dikkat

PipelineVariable kapsamı, çağrıldığı işlem hattıyla belirlenmiştir. İşlem hattı dışındaki ve aynı adı kullanan değişkenler, işlem hattı yürütülmeden önce temizlenir. işlem PipelineVariable hattı sonlandırıldığında kapsamın dışına çıkar. İşlem hattı içinde birden çok komut aynı PipelineVariable değeri belirtiyorsa, yalnızca bir paylaşılan değişken vardır. Bu değişken, değişkeni belirten komutun en son kanallı çıkışıyla güncelleştirilir.

Bazı engelleme komutları, veya gibi Sort-ObjectSelect-Object -Lastherhangi bir çıkış oluşturmadan önce tüm işlem hattı öğelerini toplar. Böyle bir engelleme komutundan önce bir komutta atananlar PipelineVariable , engelleme komutundan sonra bir komutta kullanıldığında her zaman önceki komuttan son kanallı öğeyi içerir.

Aşağıdaki örnekte nasıl çalıştığı gösterilmektedir PipelineVariable . Bu örnekte, ilk ForEach-Object komuta beş sayı aktarılır. İşlem hattındaki her öğe adlı $Tempişlem hattı değişkeninde depolanır.

Process İlk ForEach-Object komutun bloğu, işlem hattı öğesini aşağı akış ForEach-Object komutuna aktarır. Değişkenlerin durumu her adımda görüntülenir.

# Create a variable named $Temp
$Temp = 8
Get-Variable Temp | Format-Table

$InformationPreference = 'Continue'
Write-Information '-------------------------------------------------'
111,222,333,444,555 | ForEach-Object -PipelineVariable Temp -Begin {

  # Note that the newly create $Temp variable doesn't contain the value 8
  # assigned before the pipeline started and that $PSItem is empty in
  # the Begin block.
  Write-Information "Upstream (Begin):   PSItem = '$PSItem', Temp = '$Temp'"

} -Process {

  Write-Information "Upstream (Process): PSItem = '$PSItem', Temp = '$Temp'"
  return $PSItem

} | ForEach-Object -Process {

  Write-Information "`tDownstream: PSItem = '$PSItem', Temp = '$Temp'"

}
Write-Information '-------------------------------------------------'

# The $Temp variable is deleted when the pipeline finishes
Get-Variable Temp | Format-Table

Name                           Value
----                           -----
Temp                           8

-------------------------------------------------
Upstream (Begin):   PSItem = '', Temp = ''
Upstream (Process): PSItem = '111', Temp = ''
        Downstream: PSItem = '111', Temp = '111'
Upstream (Process): PSItem = '222', Temp = '111'
        Downstream: PSItem = '222', Temp = '222'
Upstream (Process): PSItem = '333', Temp = '222'
        Downstream: PSItem = '333', Temp = '333'
Upstream (Process): PSItem = '444', Temp = '333'
        Downstream: PSItem = '444', Temp = '444'
Upstream (Process): PSItem = '555', Temp = '444'
        Downstream: PSItem = '555', Temp = '555'
-------------------------------------------------

Name                           Value
----                           -----
Temp

Dikkat

CimCmdlet'leri veya CDXML cmdlet'lerini içeren bir işlem hattında parametresini kullanmayla PipelineVariable ilgili bilinen iki sorun vardır. Aşağıdaki örneklerde bir Get-Partition CDXML işlevi ve Get-CimInstance bir CimCmdlet'idir.

Sorun 1: CDXML işlevleri parametresine [CmdletBinding()] izin veren kullanırPipelineVariable.

Get-Partition -pv pvar

Ancak, Windows PowerShell v5.1'de kullandığınızda PipelineVariable aşağıdaki hatayı alırsınız.

Get-Partition : Cannot retrieve the dynamic parameters for the cmdlet.
Object reference not set to an instance of an object.

At line:1 char:1
+ get-partition -PipelineVariable pvar
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidArgument: (:) [Get-Partition], ParameterBindingException
    + FullyQualifiedErrorId : GetDynamicParametersException,Get-Partition

Sorun 2: Yukarıdaki komut bir CDXML komutu değilse ve aşağı akış her iki komut türünü de içeriyorsa, PipelineVariable son birikmiş nesne olarak kalır.

Get-CimInstance Win32_DiskDrive -pv pvar |
    ForEach-Object {
        Write-Host "Upstream: Disk $($pvar.Index)"
        return [pscustomobject]@{ DiskNumber = $_.Index }
    } | Get-Partition | ForEach-Object {
        Write-Host "Downstream: Disk $($pvar.Index)"
    }

değerinin $pvar ikinci ForEach-Object komut için işlem hattındaki son nesneye ayarlandığına dikkat edin.

Upstream: Disk 1
Upstream: Disk 2
Upstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0

-ProgressAction

PowerShell'in , Yazma İlerlemesi cmdlet'i tarafından oluşturulan ilerleme çubukları gibi bir betik, cmdlet veya sağlayıcı tarafından oluşturulan ilerleme güncelleştirmelerine nasıl yanıt vereceğini belirler. Write-Progress cmdlet'i, komutun durumunu gösteren ilerleme çubukları oluşturur. ProgressAction parametresi PowerShell 7.4'e eklendi.

ProgressAction parametresi numaralandırma değerlerinden birini ActionPreference alır: SilentlyContinue, Stop, Continue, Inquire, , Ignore, Suspendveya Break.

Geçerli değerler şunlardır:

Break hata ayıklayıcıyı Write-Progress komutunun bir örneğinde girer.
Stop: İlerleme çubuğunu görüntülemez. Bunun yerine bir hata iletisi görüntüler ve yürütmeyi durdurur.
Inquire: İlerleme çubuğunu görüntülemez. Devam etmek için izin ister. Y veya Ayanıtlarsanız ilerleme çubuğu görüntülenir.
Continue: (Varsayılan) İlerleme çubuğunu görüntüler ve yürütmeye devam eder.
SilentlyContinue: Komutu yürütür, ancak ilerleme çubuğunu görüntülemez.

Type: ActionPreference
Aliases: proga
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

-Verbose

komutu tarafından yapılan işlemle ilgili ayrıntılı bilgileri görüntüler. Bu bilgiler, izlemedeki veya işlem günlüğündeki bilgilere benzer. Bu parametre yalnızca komut ayrıntılı bir ileti oluşturduğunda çalışır. Örneğin, bir komut Write-Verbose cmdlet'ini içerdiğinde bu parametre çalışır.

Type: SwitchParameter
Aliases: vb
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Verbose parametresi geçerli komut için $VerbosePreference değişkeninin değerini geçersiz kılar. değişkeninin varsayılan değeri $VerbosePreference olduğundan SilentlyContinue, ayrıntılı iletiler varsayılan olarak görüntülenmez.

-Verbose:$true, -Verbose ile aynı etkiye sahiptir
-Verbose:$false ayrıntılı iletilerin görüntülenmesini engeller. değeri $VerbosePreference (varsayılan) olmadığında SilentlyContinue bu parametreyi kullanın.

-WarningAction

Cmdlet'in komuttan gelen bir uyarıya nasıl yanıt vereceğini belirler. Continue varsayılan değerdir. Bu parametre yalnızca komut bir uyarı iletisi oluşturduğunda çalışır. Örneğin, bir komut Write-Warning cmdlet'ini içerdiğinde bu parametre çalışır.

Type: ActionPreference
Aliases: wa
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

WarningAction parametresi geçerli komut için $WarningPreference değişkeninin değerini geçersiz kılar. değişkeninin varsayılan değeri $WarningPreference olduğundan Continue, parametresini kullanmadığınız WarningAction sürece uyarılar görüntülenir ve yürütme devam eder.

Break bir uyarı oluştuğunda hata ayıklayıcıyı girer.
Continue uyarı iletilerini görüntüler ve komutu yürütmeye devam eder. Continue varsayılan değerdir.
Inquire uyarı iletisini görüntüler ve yürütmeye devam etmeden önce sizden onay ister. Bu değer nadiren kullanılır.
SilentlyContinue uyarı iletisini gizler ve komutu yürütmeye devam eder.
Stop uyarı iletisini görüntüler ve komutu yürütmeyi durdurur.

Not

WarningAction Parametre, komutta betik veya işlev çalıştırmak için kullanıldığında parametresi geçersiz kılar, ancak tercih değişkeninin değerini $WarningAction değiştirmez.

-WarningVariable

Komutla ilgili uyarı kayıtlarını belirtilen değişkende depolar.

Type: String
Aliases: wv
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Oluşturulan tüm uyarılar kullanıcıya görüntülenmese bile değişkene kaydedilir.

Uyarıları değişken içeriğine eklemek için, orada zaten depolanmış olabilecek uyarıları değiştirmek yerine, değişken adından önce bir artı işareti (+) yazın.

Örneğin, aşağıdaki komut $a değişkenini oluşturur ve tüm uyarıları içinde depolar:

Get-Process -Id 6 -WarningVariable a

Aşağıdaki komut, $a değişkenine herhangi bir uyarı ekler:

Get-Process -Id 2 -WarningVariable +a

Aşağıdaki komut $aiçeriğini görüntüler:

$a

Bu parametreyi yalnızca belirli komutlardan gelen uyarıları içeren bir değişken oluşturmak için kullanabilirsiniz. Değişkende depolanan belirli uyarılara başvurmak için $a[0] veya $warning[1,2] gibi dizi gösterimini kullanabilirsiniz.

Not

Uyarı değişkeni, iç içe işlevlere veya betiklere yapılan çağrılar dahil olmak üzere komut tarafından oluşturulan tüm uyarıları içerir.

Risk yönetimi parametreleri

-WhatIf

Komutu yürütmek yerine komutunun etkisini açıklayan bir ileti görüntüler.

Type: SwitchParameter
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

WhatIf parametresi geçerli komut için $WhatIfPreference değişkeninin değerini geçersiz kılar. Değişkenin varsayılan değeri $WhatIfPreference 0 (devre dışı) olduğundan, WhatIf davranış parametresi olmadan WhatIf yapılmaz. Daha fazla bilgi için bkz. about_Preference_Variables.

$true, -WhatIfile aynı etkiye sahiptir.
$falsedeğişkeninin değeri WhatIf 1 olduğunda sonuç veren otomatik $WhatIfPreference davranışı bastırır.

Örneğin, aşağıdaki komut bir -WhatIf komutunda Remove-Item parametresini kullanır:

Remove-Item Date.csv -WhatIf

PowerShell, öğeyi kaldırmak yerine yapacağı işlemleri ve etkilenecek öğeleri listeler. Bu komut aşağıdaki çıkışı oluşturur:

What if: Performing operation "Remove File" on
Target "C:\ps-test\date.csv".

-Confirm

Komutu yürütmeden önce sizden onay ister.

Type: SwitchParameter
Aliases: cf
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

Confirm parametresi geçerli komut için $ConfirmPreference değişkeninin değerini geçersiz kılar. Varsayılan değer true değeridir. Daha fazla bilgi için bkz. about_Preference_Variables.

$true, -Confirmile aynı etkiye sahiptir.
$false, $ConfirmPreference değeri cmdlet'in tahmini riskinden küçük veya buna eşit olduğunda oluşan otomatik onayı bastırır.

Örneğin, aşağıdaki komut Confirm komutuyla Remove-Item parametresini kullanır. Öğeyi kaldırmadan önce PowerShell, yapacağı işlemleri ve etkilenecek öğeleri listeler ve onay ister.

PS C:\ps-test> Remove-Item tmp*.txt -Confirm

Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target " C:\ps-test\tmp1.txt
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend
[?] Help (default is "Y"):

Confirm yanıt seçenekleri şunlardır:

Yanıt	Sonuç
`Yes` (`Y`)	Eylemi gerçekleştirin.
`Yes to All` (`A`)	Tüm eylemleri gerçekleştirme ve sonraki Confirm gizleme
	bu komut için sorgular.
`No` (`N`):	Eylemi gerçekleştirmeyin.
`No to All` (`L`):	Hiçbir eylem gerçekleştirmeyin ve izleyenleri gizlemeyin
	Bu komut için sorgular Confirm.
`Suspend` (`S`):	Komutu duraklatın ve geçici bir oturum oluşturun.
`Help` (`?`)	Bu seçenekler için yardım görüntüleyin.

seçeneği Suspend komutu beklemeye alır ve bir seçenek belirlemeye hazır olana kadar çalışabileceğiniz geçici bir Confirm iç içe oturum oluşturur. İç içe oturum için komut isteminde, özgün üst komutun alt işlemi olduğunu belirtmek için iki ek giriş işareti (>>) vardır. İç içe oturumda komutları ve betikleri çalıştırabilirsiniz. İç içe oturumu sonlandırmak ve özgün komutun Confirm seçeneklerine dönmek için "exit" yazın.

Aşağıdaki örnekte, Suspend kullanıcı bir komut parametresi için yardımı denetlerken komutu geçici olarak durdurmak için (S) seçeneği kullanılır. Gerekli bilgileri aldıktan sonra, kullanıcı iç içe istemi sonlandırmak için "exit" yazıp Confirm sorgusuna Evet (y) yanıtını seçer.

PS C:\ps-test> New-Item -ItemType File -Name Test.txt -Confirm

Confirm
Are you sure you want to perform this action?

Performing operation "Create File" on Target "Destination:
C:\ps-test\test.txt".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default
is "Y"): s

PS C:\ps-test> Get-Help New-Item -Parameter ItemType

-ItemType <string>
Specifies the provider-specified type of the new item.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       true (ByPropertyName)
Accept wildcard characters?  false

PS C:\ps-test> exit

Confirm
Are you sure you want to perform this action?
Performing operation "Create File" on Target "Destination: C:\ps-test\test
.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (defau
lt is "Y"): y

Directory: C:\ps-test

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
-a---         8/27/2010   2:41 PM          0 test.txt

Ayrıca bakınız

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-04-02