Aracılığıyla paylaş

Get-Verb

Modül:
Microsoft.PowerShell.Utility Module

Onaylanan PowerShell fiillerini alır.

Syntax

Default (Varsayılan) 

Get-Verb
    [[-Verb] <String[]>]
    [[-Group] <String[]>]
    [<CommonParameters>]

Description

Get-Verb işlevi, PowerShell komutlarında kullanılmak üzere onaylanan fiilleri alır.

PowerShell cmdlet'i ve işlev adlarının Verb-Noun biçimine sahip olması ve onaylı bir fiil içermesi önerilir. Bu uygulama, komut adlarının daha tutarlı, öngörülebilir ve kullanımını kolaylaştırır.

Onaylanmamış fiiller kullanan komutlar PowerShell'de çalışmaya devam ediyor. Ancak, adında onaylanmamış bir fiil bulunan bir komut içeren bir modülü içeri aktardığınızda, Import-Module komutu bir uyarı iletisi görüntüler.

Uyarı

Get-Verb'nin döndürdüğü fiil listesi tamamlanmayabilir. Açıklamaları içeren onaylı PowerShell fiillerinin güncelleştirilmiş listesi için bkz. Onaylı Fiiller.

Örnekler

Örnek 1 - Tüm fiillerin listesini alma

Get-Verb

Örnek 2 - "un" ile başlayan onaylı fiillerin listesini alma

Get-Verb un*

Verb       AliasPrefix Group     Description
----       ----------- -----     -----------
Undo       un          Common    Sets a resource to its previous state
Unlock     uk          Common    Releases a resource that was locked
Unpublish  ub          Data      Makes a resource unavailable to others
Uninstall  us          Lifecycle Removes a resource from an indicated location
Unregister ur          Lifecycle Removes the entry for a resource from a repository
Unblock    ul          Security  Removes restrictions to a resource
Unprotect  up          Security  Removes safeguards from a resource that were added to prevent it from attack or loss

Örnek 3 - Güvenlik grubundaki tüm onaylanan fiilleri alma

Get-Verb -Group Security

Verb      AliasPrefix Group    Description
----      ----------- -----    -----------
Block     bl          Security Restricts access to a resource
Grant     gr          Security Allows access to a resource
Protect   pt          Security Safeguards a resource from attack or loss
Revoke    rk          Security Specifies an action that does not allow access to a resource
Unblock   ul          Security Removes restrictions to a resource
Unprotect up          Security Removes safeguards from a resource that were added to prevent it from attack or loss

Örnek 4 - Bir modülde onaylanmamış fiilleri olan tüm komutları bulur

Get-Command -Module Microsoft.PowerShell.Utility | Where-Object Verb -NotIn (Get-Verb).Verb

CommandType     Name            Version    Source
-----------     ----            -------    ------
Cmdlet          Sort-Object     3.1.0.0    Microsoft.PowerShell.Utility
Cmdlet          Tee-Object      3.1.0.0    Microsoft.PowerShell.Utility

Parametreler

-Group

Yalnızca belirtilen grupları alır. Grubun adını girin. Joker karakterlere izin verilmez.

Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:

String[]

Default value:All groups
Kabul edilen değerler:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:1
Zorunlu:False
İş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

-Verb

Yalnızca belirtilen fiilleri alır. Fiilin adını veya ad desenini girin. Joker karakterlere izin verilir.

Parametre özellikleri

Tür:

String[]

Default value:All verbs
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:False
İş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

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

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

VerbInfo

Notlar

PowerShell fiilleri, en yaygın kullanımlarına göre bir gruba atanır. Gruplar, kullanımlarını kısıtlamak için değil, fiilleri bulmayı ve karşılaştırmayı kolaylaştırmak için tasarlanmıştır. Herhangi bir komut türü için onaylanan herhangi bir fiili kullanabilirsiniz.

Her PowerShell fiili aşağıdaki gruplardan birine atanır.

  • Ortak: Ekle gibi neredeyse tüm cmdlet'lere uygulanabilecek genel eylemleri tanımlayın.
  • İletişimler: Bağlan gibi iletişimler için geçerli eylemleri tanımlayın.
  • Veri: Yedekleme gibi veri işlemeye uygulanan eylemleri tanımlayın.
  • Tanılama: Hata Ayıklama gibi tanılamalara uygulanan eylemleri tanımlayın.
  • Yaşam Döngüsü: Bir cmdlet'in yaşam döngüsü için geçerli olan eylemleri (Tamamlandı gibi) tanımlayın.
  • Güvenlik: İptal Etme gibi güvenliğe uygulanan eylemleri tanımlayın.
  • Diğer: Diğer eylem türlerini tanımlayın.

PowerShell ile yüklenen Tee-Object ve Where-Objectgibi bazı cmdlet'ler onaylanmamış fiiller kullanır. Bu cmdlet'ler tarihi özel durumlardır ve fiilleri ayrılmışolarak sınıflandırılır.