Aracılığıyla paylaş


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).