Remove-TypeData
Menghapus tipe yang diperluas dari sesi saat ini.
Sintaks
RemoveTypeDataSet (Default)
Remove-TypeData
-TypeData <TypeData>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveTypeSet
Remove-TypeData
[-TypeName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveFileSet
Remove-TypeData
-Path <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
cmdlet Remove-TypeData menghapus data jenis yang diperluas dari sesi saat ini. Cmdlet ini hanya memengaruhi sesi dan sesi saat ini yang dibuat dalam sesi saat ini.
Anda dapat menambahkan properti dan metode ke objek di PowerShell dengan menentukannya dalam perintah Update-TypeData dan file Types.ps1xml.
Remove-TypeData menghapus properti dan metode yang diperluas tersebut dari sesi saat ini.
Remove-TypeData tidak menghapus file Types.ps1xml atau menghapus definisi jenis yang diperluas dari file Types.ps1xml. Untuk informasi selengkapnya tentang file Types.ps1xml, lihat about_Types.ps1xml .
Cmdlet ini diperkenalkan di Windows PowerShell 3.0.
Contoh
Contoh 1: Menghapus jenis data untuk jenis tertentu
Contoh ini menghapus semua data jenis untuk jenis System.Array dari sesi, termasuk data jenis yang ditambahkan oleh file Types.ps1xml dan data jenis dinamis yang ditambahkan ke sesi dengan menggunakan cmdlet Update-TypeData.
Remove-TypeData -TypeName System.Array
Contoh 2: Menghapus jenis data yang diperluas dari sesi
Contoh ini menunjukkan efek menghapus data jenis yang diperluas dari sesi.
Get-TypeData pertama mendapatkan data jenis yang diperluas untuk jenis System.DateTime. Output menunjukkan bahwa properti DateTime telah ditambahkan ke semua objek System.DateTime di PowerShell. Cmdlet Get-Date mengembalikan objek System.DateTime. Perintah menggunakan notasi titik untuk mendapatkan nilai properti DateTime dari objek System.DateTime yang Get-Date kembalikan.
Get-TypeData System.DateTime
(Get-Date).DateTime
Get-TypeData System.DateTime | Remove-TypeData
(Get-Date).DateTime
TypeName Members
-------- -------
System.DateTime {[DateTime, System.Management.Automation.Runspaces.ScriptPropertyData]}
Friday, January 20, 2012 9:01:00 PM
Cmdlet Get-TypeData berikutnya untuk mendapatkan semua data jenis yang diperluas untuk jenis System.DateTime yang ke cmdlet Remove-TypeData untuk menghapus data jenis yang diperluas. Cmdlet Get-Date terakhir menunjukkan efek menghapus data jenis yang diperluas untuk jenis System.DateTime. Karena properti System.DateTime tidak ada lagi, perintah untuk mendapatkan nilainya tidak mengembalikan apa pun.
Contoh 3: Menghapus jenis yang diperluas untuk modul
Contoh ini menghapus semua data jenis yang diperluas untuk objek modul. Saat Anda menyalurkan objek ke Remove-TypeData, Remove-TypeData mendapatkan nama jenis objek dan menghapus semua jenis data untuk semua objek jenis tersebut.
Get-Module | Remove-TypeData
Contoh 4: Menghapus jenis yang diperluas dari modul tertentu
Contoh ini menggunakan parameter Jalur dari cmdlet Remove-TypeData untuk menghapus jenis yang diperluas yang ditentukan dalam file Types.ps1xml yang ditambahkan oleh PSScheduledJob dan modul PSWorkflow. Perintah ini tidak memengaruhi data jenis dinamis yang ditambahkan dengan menggunakan cmdlet Update-TypeData. Perintah hanya berhasil ketika modul telah diimpor ke sesi saat ini.
Remove-TypeData -Path "$PSHOME\Modules\PSScheduledJob", "$PSHOME\Modules\PSWorkflow\PSWorkflow.types.ps1xml"
Untuk informasi selengkapnya tentang modul, lihat about_Modules.
Contoh 5: Menghapus jenis yang diperluas dari sesi jarak jauh
Contoh ini menghapus jenis yang diperluas dari sesi jarak jauh. Perintah menggunakan cmdlet Invoke-Command untuk menghapus data jenis yang diperluas untuk semua jenis CIM dalam sesi dalam variabel $S.
Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}
Parameter
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Path
Menentukan array file yang dihapus cmdlet ini dari data jenis sesi yang diperluas. Parameter ini diperlukan.
Masukkan jalur dan nama file dari satu atau beberapa file Types.ps1xml. Kartubebas tidak didukung. Jika Anda menghilangkan jalur, lokasi default adalah direktori saat ini.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
RemoveFileSet
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-TypeData
Menentukan jenis data yang dihapus cmdlet ini dari sesi. Parameter ini diperlukan. Masukkan variabel yang berisi objek TypeData (System.Management.Automation.Runspaces.TypeData) atau perintah yang mendapatkan objek TypeData, seperti perintah Get-TypeData. Anda juga dapat menyalurkan objek TypeData ke Remove-TypeData.
Properti parameter
| Jenis: | TypeData |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
RemoveTypeDataSet
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-TypeName
Menentukan tipe yang digunakan cmdlet ini untuk menghapus semua data tipe yang diperluas. Untuk jenis di namespace layanan Sistem, masukkan nama pendek. Jika tidak, nama jenis lengkap diperlukan. Kartubebas tidak didukung.
Anda dapat mengetik nama pipa untuk Remove-TypeData. Saat Anda menyalurkan objek ke Remove-TypeData, Remove-TypeData mendapatkan nama jenis objek dan menghapus semua jenis data untuk jenis objek.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
RemoveTypeSet
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Input
TypeData
Anda dapat menyalurkan objek typeData, seperti yang dikembalikan cmdlet Get-TypeData, ke cmdlet ini.
String
Anda dapat menyalurkan string yang berisi nama jenis ke cmdlet ini. Saat Anda menyalurkan objek ke cmdlet ini, objek mendapatkan nama jenis objek dan menghapus semua data jenis untuk jenis objek.
Output
None
Cmdlet ini tidak mengembalikan output.
Catatan
Remove-TypeData hanya dapat menghapus data jenis yang diperluas dalam sesi saat ini. Ini tidak dapat menghapus data tipe yang diperluas yang ada di komputer, tetapi belum ditambahkan ke sesi saat ini, seperti tipe yang diperluas yang ditentukan dalam modul yang belum diimpor ke sesi saat ini.
