Remove-TypeData
現在のセッションから拡張型を削除します。
構文
Remove-TypeData
-TypeData <TypeData>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-TypeData
[-TypeName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-TypeData
-Path <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
コマンドレットは Remove-TypeData
、現在のセッションから拡張型データを削除します。 このコマンドレットは、現在のセッションと、現在のセッションで作成されたセッションにのみ作用します。
PowerShell のオブジェクトにプロパティとメソッドを追加するには、コマンドとTypes.ps1xml
ファイルでUpdate-TypeData
定義します。 Remove-TypeData
は、これらの拡張プロパティとメソッドを現在のセッションから削除します。 Remove-TypeData
は、ファイルを削除したり、 Types.ps1xml
拡張型定義を Types.ps1xml
ファイルから削除したりしません。 ファイルの詳細 Types.ps1xml
については、「 about_Types.ps1xml」を参照してください。
このコマンドレットは、Windows PowerShell 3.0 で導入されました。
例
例 1: 指定した型の型データを削除する
次の使用例は、ファイルによって追加された型データや、 コマンドレットを使用してTypes.ps1xml
セッションに追加された動的な型データなど、System.Array 型のすべての型データをUpdate-TypeData
セッションから削除します。
Remove-TypeData -TypeName System.Array
例 2: セッションから拡張データ型を削除する
この例では、セッションから拡張型データを削除する効果を示します。 最初 Get-TypeData
の は 、System.DateTime 型の拡張型データを取得します。 出力は、 PowerShell のすべての System.DateTime オブジェクトに DateTime プロパティが追加されたことを示しています。 コマンドレットは Get-Date
System.DateTime オブジェクトを返します。 コマンドは、ドット表記を使用して、返される System.DateTime オブジェクトの DateTime プロパティの値をGet-Date
取得します。
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 型のすべての拡張型データを取得し、そのデータをコマンドレットにパイプしてRemove-TypeData
拡張型データを削除する次Get-TypeData
のコマンドレット。 最後 Get-Date
のコマンドレットは、 System.DateTime 型の拡張型データを削除した結果を示しています。 System.DateTime プロパティは存在しなくなったため、その値を取得するコマンドは何も返しません。
例 3: モジュールの拡張型を削除する
この例では、モジュール オブジェクトのすべての拡張型データを削除します。 オブジェクトを にRemove-TypeData
Remove-TypeData
パイプ処理すると、オブジェクト型の名前が取得され、その型のすべてのオブジェクトのすべての型データが削除されます。
Get-Module | Remove-TypeData
例 4: 指定したモジュールから拡張型を削除する
この例では、 コマンドレットの Path パラメーターをRemove-TypeData
使用して、PSScheduledJob モジュールと PSWorkflow モジュールによって追加されるファイルでTypes.ps1xml
定義されている拡張型を削除します。 このコマンドは、 コマンドレットを使用して追加された動的な型データには Update-TypeData
影響しません。 このコマンドは、モジュールが現在のセッションにインポートされている場合にのみ成功します。
Remove-TypeData -Path "$PSHOME\Modules\PSScheduledJob", "$PSHOME\Modules\PSWorkflow\PSWorkflow.types.ps1xml"
モジュールの詳細については、「 about_Modules」を参照してください。
例 5: リモート セッションから拡張型を削除する
この例では、リモート セッションから拡張型を削除します。 コマンドは、 コマンドレットを Invoke-Command
使用して、 変数内のセッション内のすべての CIM 型の拡張型データを $S
削除します。
Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
このコマンドレットがセッション拡張型データから削除するファイルの配列を指定します。 このパラメーターは必須です。
1 つ以上 Types.ps1xml
のファイルのパスとファイル名を入力します。 ワイルドカードはサポートされていません。 パスを省略した場合、現在のディレクトリが既定の場所になります。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TypeData
このコマンドレットがセッションから削除する型データを指定します。 このパラメーターは必須です。 TypeData オブジェクト (System.Management.Automation.Runspaces.TypeData) を含む変数、または TypeData オブジェクトを取得するコマンド (コマンドなど) をGet-TypeData
入力します。 TypeData オブジェクトを にRemove-TypeData
パイプすることもできます。
Type: | TypeData |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TypeName
このコマンドレットがすべての拡張型データを削除する型を指定します。 System 名前空間の型に対しては、短い名前を入力します。 それ以外の場合は、完全な型名が必要です。 ワイルドカードはサポートされていません。
型名を に Remove-TypeData
パイプできます。 オブジェクトを にRemove-TypeData
Remove-TypeData
パイプ処理すると、オブジェクトの型名が取得され、オブジェクト型のすべての型データが削除されます。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
コマンドレットから返される TypeData オブジェクトなどの TypeData オブジェクトを Get-TypeData
に Remove-TypeData
パイプできます。
型名を に Remove-TypeData
パイプできます。 オブジェクトを にRemove-TypeData
Remove-TypeData
パイプ処理すると、オブジェクトの型名が取得され、オブジェクト型のすべての型データが削除されます。
出力
None
このコマンドレットは出力を生成しません。
メモ
Remove-TypeData
では、現在のセッションの拡張型データのみを削除できます。 このコマンドレットは、モジュールに定義されている一方で現在のセッションにインポートされていない拡張型のように、コンピューター上に存在していて現在のセッションに追加されていない拡張型データは削除できません。