Aracılığıyla paylaş

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, Verbose genel parametresinin kullanılmasının hiçbir etkisi yoktur.

Ortak parametreler, özniteliğini veya özniteliğini kullanan gelişmiş işlevlerde CmdletBindingParameter 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:

Veri Akışı 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 cmdlet'ini içerdiğinde Write-Debug 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 ile aynı etkiye -Debugsahiptir. Hata ayıklama iletilerinin görüntülenme biçimini varsayılan değer değilken -Debug:$false$DebugPreferenceengellemek için kullanınSilentlyContinue.

-Hata Eylemi

cmdlet'in komuttan sonlandırılmayan bir hataya nasıl yanıt vereceğini belirler. Bu parametre yalnızca komut cmdlet'indekiler gibi sonlandırıcı olmayan bir hata oluşturduğunda Write-Error çalışır.

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

parametresi, ErrorAction geçerli komut için değişkenin $ErrorActionPreference 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.

parametresinin ErrorAction , bir komutun başarıyla tamamlanmasını engelleyen sonlandırma hataları (eksik veriler, geçerli olmayan parametreler veya yetersiz izinler gibi) üzerinde hiçbir etkisi yoktur.

  • 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. SilentlyContinue'den farklı olarakIgnore, hata iletisini otomatik değişkene $Error 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.
  • 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 değişkende $Error otomatik olarak 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 değişkeni oluşturur $a ve ardından içindeki hataları depolar:

Get-Process -Id 6 -ErrorVariable a

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

Get-Process -Id 2 -ErrorVariable +a

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

$a

Bu parametreyi yalnızca belirli komutlardan gelen hata iletilerini içeren ve otomatik değişkenin $Error davranışını etkilemeyen bir değişken oluşturmak için kullanabilirsiniz. Otomatik $Error değişken, oturumdaki tüm komutlardan gelen hata iletilerini içerir. Değişkenlerde depolanan belirli hatalara başvurmak için veya $a[0] gibi $Error[1,2] 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.

-Bilgi Eylemi

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ısını komutun bir örneğinde Write-Information girer.
  • Stop komutu veya betiği, komutun Write-Information bir örneğinde 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 , bir Write-Information komutta 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 yalnızca iş akışları için kullanılabilir olduğundan PowerShell 6 ve üzeri sürümlerde desteklenmez.
  • SilentlyContinue bilgilendirme iletisi (Varsayılan) görüntülenmediğinden ve betik kesintisiz olarak 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.

-Bilgi Değişkeni

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 cmdlet'ini Write-Information 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. Tercih değişkenini kullanarak $InformationPreference davranışı da 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 (Dışarı)

İş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 verileri toplu olarak OutBuffer + 1sonraki cmdlet'e gönderir.

Aşağıdaki örnek, cmdlet'ini kullanan ForEach-Object işlem blokları arasında Write-Host 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şkene eklemek için, orada zaten 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 değişkeni oluşturur $out ve işlem nesnesini içinde depolar:

Get-Process powershell -OutVariable out

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

Get-Process iexplore -OutVariable +out

Aşağıdaki komut değişkenin $out 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 çok üç 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 PipelineVariable parametresini kullanmayla 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 [CmdletBinding()] parametresine izin veren öğesini kullanır.

Get-Partition -pv pvar

Ancak, Windows PowerShell v5.1'de PipelineVariable kullandığınızda 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

-İlerleme Eylemi

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. Cmdlet, Write-Progress bir 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ısını komutun bir örneğinde Write-Progress 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. veya Yile A yanı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 cmdlet'ini içerdiğinde Write-Verbose bu parametre çalışır.

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

parametresi, Verbose geçerli komut için değişkenin $VerbosePreference 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 ile aynı etkiye sahiptir -Verbose
  • -Verbose:$false ayrıntılı iletilerin görüntülenmesini engeller. değeri $VerbosePreference (varsayılan) olmadığında SilentlyContinue bu parametreyi kullanın.

-Uyarı Eylemi

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 cmdlet'ini içerdiğinde Write-Warning 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

parametresi, WarningAction geçerli komut için değişkenin $WarningPreference 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ısını 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 bastırır 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 değişkeni oluşturur $a ve sonra içinde tüm uyarıları depolar:

Get-Process -Id 6 -WarningVariable a

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

Get-Process -Id 2 -WarningVariable +a

Aşağıdaki komut içeriğini $agö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şkeninde depolanan belirli uyarılara başvurmak için veya $a[0] gibi $warning[1,2] 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

parametresi, WhatIf geçerli komut için değişkenin $WhatIfPreference 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 ile aynı etkiye -WhatIfsahiptir.
  • $false değişkeninin değeri $WhatIfPreference 1 olduğunda sonuç veren otomatik WhatIf davranışını bastırır.

Örneğin, aşağıdaki komut bir -WhatIf komutta parametresini Remove-Item 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

parametresi, Confirm geçerli komut için değişkenin $ConfirmPreference değerini geçersiz kılar. Varsayılan değer doğru'dur. Daha fazla bilgi için bkz. about_Preference_Variables.

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

Örneğin, aşağıdaki komut parametresini Confirm bir Remove-Item komutla 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"):

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

Yanıt Sonuç
Yes (Y) Eylemi gerçekleştirin.
Yes to All (A) Tüm eylemleri gerçekleştirme ve izleyenleri gizleme Confirm
bu komut için sorgular.
No (N): Eylemi gerçekleştirmeyin.
No to All (L): Hiçbir eylem gerçekleştirmeyin ve izleyenleri gizlemeyin
Confirm bu komut için sorgular.
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, bunun özgün üst komutun alt işlemi olduğunu belirten 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 sorguya Evet (y) yanıtını Confirm 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

  • Last updated on