Remove-TypeData
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-TypeData
Remove-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-TypeData
de 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-TypeData
yöneltebilirsiniz. Bir nesneyi öğesine Remove-TypeData
Remove-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
Cmdlet'in döndürdüğü gibi Get-TypeData
bir TypeData nesnesini bu cmdlet'e yöneltebilirsiniz.
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).
İlişkili Bağlantılar
PowerShell
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin