Remove-TypeData

Menghapus tipe yang diperluas dari sesi saat ini.

Sintaks

Remove-TypeData
      -TypeData <TypeData>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-TypeData
      [-TypeName] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-TypeData
      -Path <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Remove-TypeData Cmdlet 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 mendefinisikannya dalam Update-TypeData perintah dan Types.ps1xml file. Remove-TypeData menghapus properti dan metode yang diperluas tersebut dari sesi saat ini. Remove-TypeData tidak menghapus Types.ps1xml file atau menghapus definisi jenis yang diperluas dari Types.ps1xml file. Untuk informasi selengkapnya tentang Types.ps1xml file, lihat about_Types.ps1xml.

Cmdlet ini diperkenalkan pada Windows PowerShell 3.0.

Contoh

Contoh 1: Menghapus data jenis untuk jenis tertentu

Contoh ini menghapus semua data jenis untuk jenis System.Array dari sesi, termasuk data jenis yang ditambahkan oleh Types.ps1xml file dan data jenis dinamis yang ditambahkan ke sesi dengan menggunakan Update-TypeData cmdlet .

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. Yang pertama Get-TypeData mendapatkan data jenis yang diperluas untuk jenis System.DateTime . Output menunjukkan bahwa properti DateTime telah ditambahkan ke semua objek System.DateTime di PowerShell. Get-Date Cmdlet mengembalikan objek System.DateTime. Perintah menggunakan notasi titik untuk mendapatkan nilai properti DateTime dari objek System.DateTime yang Get-Date dikembalikan.

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 berikutnya Get-TypeData untuk mendapatkan semua data jenis yang diperluas untuk jenis System.DateTime dan pipa yang ke Remove-TypeData cmdlet untuk menghapus data jenis yang diperluas. Cmdlet terakhir Get-Date 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 data jenis untuk semua objek jenis tersebut.

Get-Module | Remove-TypeData

Contoh 4: Menghapus jenis yang diperluas dari modul tertentu

Contoh ini menggunakan parameter Jalur cmdlet Remove-TypeData untuk menghapus jenis yang diperluas yang ditentukan dalam Types.ps1xml file yang ditambahkan oleh modul PSScheduledJob dan PSWorkflow . Perintah ini tidak memengaruhi data jenis dinamis yang ditambahkan dengan menggunakan Update-TypeData cmdlet . 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 Invoke-Command cmdlet untuk menghapus data jenis yang diperluas untuk semua jenis CIM dalam sesi dalam $S variabel.

Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters: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 Types.ps1xml file. Kartu bebas tidak didukung. Jika Anda menghilangkan jalur, lokasi default adalah direktori saat ini.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TypeData

Menentukan data jenis 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 Get-TypeData perintah. Anda juga dapat menyalurkan objek TypeData ke Remove-TypeData.

Type:TypeData
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-TypeName

Menentukan jenis yang cmdlet ini menghapus semua data jenis yang diperluas. Untuk jenis di namespace layanan Sistem, masukkan nama pendek. Jika tidak, nama jenis lengkap diperlukan. Kartu bebas tidak didukung.

Anda dapat menyalurkan nama jenis ke Remove-TypeData. Saat Anda menyalurkan objek ke Remove-TypeData, Remove-TypeData mendapatkan nama jenis objek dan menghapus semua data jenis untuk jenis objek.

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

TypeData

Anda dapat menyalurkan objek TypeData , seperti objek yang Get-TypeData dikembalikan cmdlet, ke Remove-TypeData.

String

Anda dapat menyalurkan nama jenis ke Remove-TypeData. Saat Anda menyalurkan objek ke Remove-TypeData, Remove-TypeData mendapatkan nama jenis objek dan menghapus semua data jenis untuk jenis objek.

Output

None

Cmdlet ini tidak menghasilkan output apa pun.

Catatan

Remove-TypeData hanya dapat menghapus data tipe 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 jenis yang diperluas yang ditentukan dalam modul yang belum diimpor ke sesi saat ini.