Remove-TypeData

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

Geçerli oturumdan genişletilmiş türleri siler.

Syntax

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

Description

Remove-TypeData Cmdlet, genişletilmiş tür verilerini geçerli oturumdan siler. Bu cmdlet yalnızca geçerli oturumu ve geçerli oturumda oluşturulan oturumları etkiler.

PowerShell'deki nesnelere komutlarda ve dosyalarda Update-TypeData tanımlayarak özellikler ve Types.ps1xml yöntemler ekleyebilirsiniz. Remove-TypeData bu genişletilmiş özellikleri ve yöntemleri geçerli oturumdan siler. Remove-TypeData dosyaları silmez Types.ps1xml veya dosyalardan Types.ps1xml genişletilmiş tür tanımlarını silmez. Dosyalar hakkında Types.ps1xml daha fazla bilgi için bkz . about_Types.ps1xml.

Bu cmdlet, Windows PowerShell 3.0'da kullanıma sunulmuştur.

Örnekler

Örnek 1: Belirtilen tür için tür verilerini kaldırma

Bu örnek, bir dosya tarafından Types.ps1xml eklenen tür verileri ve cmdlet kullanılarak oturuma eklenen dinamik tür verileri de dahil olmak üzere System.Array türü için tüm tür verilerini oturumdan Update-TypeData siler.

Remove-TypeData -TypeName System.Array

Örnek 2: Genişletilmiş veri türünü oturumdan kaldırma

Bu örnek, genişletilmiş tür verilerini bir oturumdan kaldırmanın etkisini gösterir. İlki Get-TypeData System.DateTime türü için genişletilmiş tür verilerini alır. Çıktı, PowerShell'deki tüm System.DateTime nesnelerine bir DateTime özelliğinin eklendiğini gösterir. Get-Date Cmdlet bir System.DateTime nesnesi döndürür. Komutu, döndüren System.DateTime nesnesinin Get-Date DateTime özelliğinin değerini almak için nokta gösterimini kullanır.

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

System.DateTime türü için tüm genişletilmiş tür verilerini almak için sonraki Get-TypeData cmdlet ve genişletilmiş tür verilerini silmek için Remove-TypeData cmdlet'e gelen kanallar. Son Get-Date cmdlet, System.DateTime türü için genişletilmiş tür verilerini silmenin etkisini gösterir. System.DateTime özelliği artık mevcut olmadığından değerini almak için bir komut hiçbir şey döndürmez.

Örnek 3: Modüller için genişletilmiş türleri kaldırma

Bu örnek, modül nesneleri için tüm genişletilmiş tür verilerini kaldırır. Bir nesneyi öğesine Remove-TypeDataRemove-TypeData aktardığınızda, nesne türünün adını alır ve bu türdeki tüm nesneler için tüm tür verilerini kaldırır.

Get-Module | Remove-TypeData

Örnek 4: Belirtilen modüllerden genişletilmiş türleri kaldırma

Bu örnekte, PSScheduledJob ve PSWorkflow modülleri tarafından eklenen dosyalarda tanımlanan genişletilmiş türleri kaldırmak için cmdlet'in Types.ps1xml Path parametresi Remove-TypeData kullanılır. Bu komut, cmdlet'i kullanılarak Update-TypeData eklenen dinamik tür verilerini etkilemez. Komut yalnızca modüller geçerli oturuma aktarıldığında başarılı olur.

Remove-TypeData -Path "$PSHOME\Modules\PSScheduledJob", "$PSHOME\Modules\PSWorkflow\PSWorkflow.types.ps1xml"

Modüller hakkında daha fazla bilgi için bkz . about_Modules.

Örnek 5: Uzak oturumdan genişletilmiş türleri kaldırma

Bu örnek, uzak oturumdan genişletilmiş türleri kaldırır. komutu, değişkendeki Invoke-Command oturumlardaki tüm CIM türleri için genişletilmiş tür verilerini kaldırmak için cmdlet'ini $S kullanır.

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

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-Path

Bu cmdlet'in oturum genişletilmiş tür verilerinden sileceği dosya dizisini belirtir. Bu parametre zorunludur.

Bir veya daha fazla Types.ps1xml dosyanın yollarını ve dosya adlarını girin. Joker karakterler desteklenmez. Yolu atlarsanız, varsayılan konum geçerli dizindir.

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

-TypeData

Bu cmdlet'in oturumdan sileceği tür verilerini belirtir. Bu parametre zorunludur. TypeData nesnelerini (System.Management.Automation.Runspaces.TypeData) içeren bir değişken veya komut gibi TypeData nesnelerini alan bir Get-TypeData komut girin. TypeData nesnelerini öğesine Remove-TypeDatade yöneltebilirsiniz.

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

-TypeName

Bu cmdlet'in tüm genişletilmiş tür verilerini sileceği türleri belirtir. Sistem ad alanı içindeki türler için kısa adı girin. Aksi takdirde, tam tür adı gereklidir. Joker karakterler desteklenmez.

Tür adlarını adresine Remove-TypeDatayöneltebilirsiniz. Bir nesneyi öğesine Remove-TypeDataRemove-TypeData yönelttiğinde, nesnenin tür adını alır ve nesne türü için tüm tür verilerini kaldırır.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Girişler

TypeData

Cmdlet'in döndürdüğü gibi Get-TypeData bir TypeData nesnesini bu cmdlet'e yöneltebilirsiniz.

String

Tür adını içeren bir dizeyi bu cmdlet'e yöneltebilirsiniz. Bir nesneyi bu cmdlet'e yönelttiğinde, nesnenin tür adını alır ve nesne türü için tüm tür verilerini kaldırır.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

Remove-TypeData yalnızca geçerli oturumdaki genişletilmiş tür verilerini kaldırabilir. Bilgisayardaki genişletilmiş tür verilerini kaldıramaz, ancak geçerli oturuma eklenmemiş olan genişletilmiş türler (geçerli oturuma aktarılmayan modüllerde tanımlanan genişletilmiş türler gibi).