Remove-TypeData
Geçerli oturumdan genişletilmiş türleri siler.
Sözdizimi
RemoveTypeDataSet EnterprisePublishing
Remove-TypeData
-TypeData <TypeData>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveTypeSet
Remove-TypeData
[-TypeName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveFileSet
Remove-TypeData
-Path <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Remove-TypeData cmdlet'i 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 özellikleri ve yöntemleri Update-TypeData komutlarda ve Types.ps1xml dosyalarda tanımlayarak ekleyebilirsiniz.
Remove-TypeData bu genişletilmiş özellikleri ve yöntemleri geçerli oturumdan siler.
Remove-TypeData
Types.ps1xml dosyalarını silmez veya Types.ps1xml dosyalardan genişletilmiş tür tanımlarını silmez.
Types.ps1xml dosyaları hakkında 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, dosyası tarafından eklenen tür verileri ve Types.ps1xml cmdlet'i kullanılarak oturuma eklenen dinamik tür verileri de dahil olmak üzere Update-TypeData türü için tüm tür verilerini oturumdan 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. İlk 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'i bir System.DateTime nesnesi döndürür. Komut, döndürdüğü System.DateTime nesnesinin Get-Date özelliğinin değerini almak için noktalı gösterimi 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
Get-TypeData türüne yönelik tüm genişletilmiş tür verilerini almak için sonraki cmdlet'i ve genişletilmiş tür verilerini silmek için Remove-TypeData cmdlet'ine kanallar. Son Get-Date cmdlet'i, 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 Remove-TypeDataRemove-TypeData 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 tarafından eklenen Remove-TypeData dosyalarında tanımlanan genişletilmiş türleri kaldırmak ve PSWorkflow Types.ps1xml için cmdlet'in Yol parametresi kullanılır. Bu komut, Update-TypeData cmdlet'i kullanılarak 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. komut, Invoke-Command cmdlet'ini kullanarak $S değişkenindeki oturumlardaki tüm CIM türleri için genişletilmiş tür verilerini kaldırır.
Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Path
Bu cmdlet'in oturum genişletilmiş tür verilerinden sileceği dosya dizisini belirtir. Bu parametre gereklidir.
Bir veya daha fazla Types.ps1xml dosyasının yollarını ve dosya adlarını girin. Joker karakterler desteklenmez. Yolu belirtmezseniz, varsayılan konum geçerli dizindir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
RemoveFileSet
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-TypeData
Bu cmdlet'in oturumdan sileceği tür verilerini belirtir. Bu parametre gereklidir.
TypeData nesnelerini (System.Management.Automation.Runspaces.TypeData)içeren bir değişken veya komutu gibi Get-TypeData nesneleri alan bir komut girin. TypeData Remove-TypeData de kanal oluşturabilirsiniz.
Parametre özellikleri
| Tür: | TypeData |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
RemoveTypeDataSet
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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ı Remove-TypeDatakanala ekleyebilirsiniz. bir nesneyi Remove-TypeData'a yönelttiğinde Remove-TypeData nesnenin tür adını alır ve nesne türü için tüm tür verilerini kaldırır.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
RemoveTypeSet
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
TypeData
cmdlet'in döndürdüğü nesneler gibi bir Get-TypeData nesnesini bu cmdlet'e aktarabilirsiniz.
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).