Get-Verb

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Mendapatkan kata kerja PowerShell yang disetujui.

Sintaks

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

Deskripsi

Fungsi ini Get-Verb mendapatkan kata kerja yang disetujui untuk digunakan dalam perintah PowerShell.

Disarankan agar cmdlet PowerShell dan nama fungsi memiliki Verb-Noun format dan menyertakan kata kerja yang disetujui. Praktik ini membuat nama perintah lebih konsisten, dapat diprediksi, dan lebih mudah digunakan.

Perintah yang menggunakan kata kerja yang tidak disetujui, masih berjalan di PowerShell. Namun, saat Anda mengimpor modul yang menyertakan perintah dengan kata kerja yang tidak disetujui dalam namanya, Import-Module perintah akan menampilkan pesan peringatan.

Catatan

Daftar kata kerja yang Get-Verb mengembalikan mungkin tidak lengkap. Untuk daftar kata kerja PowerShell yang disetujui yang diperbarui dengan deskripsi, lihat Kata Kerja yang Disetujui.

Contoh

Contoh 1 - Dapatkan daftar semua kata kerja

Get-Verb

Contoh 2 - Dapatkan daftar kata kerja yang disetujui yang dimulai dengan "un"

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

Contoh 3 - Dapatkan semua kata kerja yang disetujui di grup Keamanan

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

Contoh 4 - Menemukan semua perintah dalam modul yang memiliki kata kerja yang tidak disetujui

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

Parameter

-Group

Hanya mendapatkan grup yang ditentukan. Masukkan nama grup. Kartubebas tidak diperbolehkan.

Parameter ini diperkenalkan di PowerShell 6.0.

Type:String[]
Accepted values:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Position:1
Default value:All groups
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Verb

Hanya mendapatkan kata kerja yang ditentukan. Masukkan nama kata kerja atau pola nama. Kartubebas diperbolehkan.

Type:String[]
Position:0
Default value:All verbs
Required:False
Accept pipeline input:True
Accept wildcard characters:True

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

VerbInfo

Catatan

Kata kerja PowerShell ditetapkan ke grup berdasarkan penggunaan yang paling umum. Grup dirancang untuk membuat kata kerja mudah ditemukan dan dibandingkan, tidak membatasi penggunaannya. Anda dapat menggunakan kata kerja yang disetujui untuk semua jenis perintah.

Setiap kata kerja PowerShell ditetapkan ke salah satu grup berikut.

  • Umum: Tentukan tindakan umum yang dapat berlaku untuk hampir semua cmdlet, seperti Tambahkan.
  • Komunikasi: Tentukan tindakan yang berlaku untuk komunikasi, seperti Koneksi.
  • Data: Tentukan tindakan yang berlaku untuk penanganan data, seperti Pencadangan.
  • Diagnostik: Tentukan tindakan yang berlaku untuk diagnostik, seperti Debug.
  • Siklus hidup: Tentukan tindakan yang berlaku untuk siklus hidup cmdlet, seperti Selesai.
  • Keamanan: Tentukan tindakan yang berlaku untuk keamanan, seperti Cabut.
  • Lainnya: Tentukan jenis tindakan lainnya.

Beberapa cmdlet yang diinstal dengan PowerShell, seperti Tee-Object dan Where-Object, gunakan kata kerja yang tidak disetujui. Cmdlet ini adalah pengecualian historis dan kata kerjanya diklasifikasikan sebagai dicadangkan.