Remove-TypeData
현재 세션에서 확장 유형을 삭제합니다.
구문
Remove-TypeData
-TypeData <TypeData>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-TypeData
[-TypeName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-TypeData
-Path <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
cmdlet은 Remove-TypeData
현재 세션에서 확장 형식 데이터를 삭제합니다. 이 cmdlet은 현재 세션에서 만든 현재 세션 및 세션에만 영향을 줍니다.
명령 및 파일에서 정의하여 PowerShell의 개체에 Update-TypeData
속성과 Types.ps1xml
메서드를 추가할 수 있습니다. Remove-TypeData
는 현재 세션에서 해당 확장 속성 및 메서드를 삭제합니다. Remove-TypeData
는 파일을 삭제 Types.ps1xml
하거나 파일에서 Types.ps1xml
확장 형식 정의를 삭제하지 않습니다. 파일에 대한 Types.ps1xml
자세한 내용은 about_Types.ps1xml을 참조 하세요.
이 cmdlet은 Windows PowerShell 3.0에서 도입되었습니다.
예제
예제 1: 지정된 형식에 대한 형식 데이터 제거
다음은 파일에서 추가한 형식 데이터와 cmdlet을 사용하여 Update-TypeData
세션에 추가 Types.ps1xml
된 동적 형식 데이터를 포함하여 세션에서 System.Array 형식에 대한 모든 형식 데이터를 삭제하는 예제입니다.
Remove-TypeData -TypeName System.Array
예제 2: 세션에서 확장 데이터 형식 제거
이 예제에서는 세션에서 확장 형식 데이터를 제거하는 효과를 보여줍니다. 첫 번째는 Get-TypeData
System.DateTime 형식에 대한 확장 형식 데이터를 가져옵니다. 출력은 DateTime 속성이 PowerShell의 모든 System.DateTime 개체에 추가되었음을 보여줍니다. cmdlet은 Get-Date
System.DateTime 개체를 반환합니다. 이 명령은 점 표기법을 사용하여 반환하는 System.DateTime 개체 Get-Date
의 DateTime 속성 값을 가져옵니다.
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 형식에 대한 모든 확장 형식 데이터를 가져오는 다음 Get-TypeData
cmdlet이며 확장 형식 데이터를 삭제하기 위해 Remove-TypeData
cmdlet으로 파이프합니다. 마지막 Get-Date
cmdlet은 System.DateTime 형식에 대한 확장 형식 데이터를 삭제하는 효과를 보여줍니다. System.DateTime 속성이 더 이상 존재하지 않으므로 해당 값을 가져오는 명령은 아무 것도 반환하지 않습니다.
예제 3: 모듈에 대한 확장 형식 제거
다음은 모듈 개체에 대한 모든 확장 형식 데이터를 제거하는 예제입니다. 개체를 파이프할 Remove-TypeData
Remove-TypeData
때 개체 형식의 이름을 가져오고 해당 형식의 모든 개체에 대한 모든 형식 데이터를 제거합니다.
Get-Module | Remove-TypeData
예제 4: 지정된 모듈에서 확장 형식 제거
이 예제에서는 cmdlet의 Remove-TypeData
Path 매개 변수를 사용하여 PSScheduledJob 및 PSWorkflow 모듈에 Types.ps1xml
의해 추가된 파일에 정의된 확장 형식을 제거합니다. 이 명령은 cmdlet을 사용하여 Update-TypeData
추가되는 동적 형식 데이터에는 영향을 주지 않습니다. 이 명령은 모듈을 현재 세션으로 가져온 경우에만 성공합니다.
Remove-TypeData -Path "$PSHOME\Modules\PSScheduledJob", "$PSHOME\Modules\PSWorkflow\PSWorkflow.types.ps1xml"
모듈에 대한 자세한 내용은 about_Modules 참조하세요.
예제 5: 원격 세션에서 확장 형식 제거
이 예제에서는 원격 세션에서 확장 형식을 제거합니다. 이 명령은 cmdlet을 Invoke-Command
사용하여 변수의 세션에 있는 모든 CIM 형식에 대한 확장 형식 데이터를 제거합니다 $S
.
Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Path
이 cmdlet이 세션 확장 형식 데이터에서 삭제하는 파일 배열을 지정합니다. 이 매개 변수는 필수입니다.
하나 이상의 Types.ps1xml
파일의 경로 및 파일 이름을 입력합니다. 와일드카드는 지원되지 않습니다. 경로를 생략하면 기본 위치는 현재 디렉터리입니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-TypeData
이 cmdlet이 세션에서 삭제하는 형식 데이터를 지정합니다. 이 매개 변수는 필수입니다. TypeData 개체(System.Management.Automation.Runspaces.TypeData)가 포함된 변수 또는 TypeData 개체를 가져오는 명령(예: 명령)을 Get-TypeData
입력합니다. TypeData 개체를 .에 파이프할 Remove-TypeData
수도 있습니다.
형식: | TypeData |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-TypeName
이 cmdlet이 모든 확장 형식 데이터를 삭제하는 형식을 지정합니다. 시스템 네임스페이스의 형식에 대해 짧은 이름을 입력합니다. 그렇지 않으면 전체 형식 이름이 필요합니다. 와일드카드는 지원되지 않습니다.
형식 이름을 .에 파이프할 Remove-TypeData
수 있습니다. 개체를 파이프할 Remove-TypeData
Remove-TypeData
때 개체의 형식 이름을 가져오고 개체 형식에 대한 모든 형식 데이터를 제거합니다.
형식: | String |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
cmdlet이 반환하는 개체와 같은 TypeData 개체를 Get-TypeData
이 cmdlet으로 파이프할 수 있습니다.
형식 이름을 포함하는 문자열을 이 cmdlet으로 파이프할 수 있습니다. 개체를 이 cmdlet으로 파이프하면 개체의 형식 이름을 가져오고 개체 형식에 대한 모든 형식 데이터를 제거합니다.
출력
None
이 cmdlet은 출력을 반환하지 않습니다.
참고
Remove-TypeData
는 현재 세션에서 확장 형식 데이터만 제거할 수 있습니다. 컴퓨터에 있지만 현재 세션으로 가져오지 않은 모듈에 정의된 확장 형식과 같이 현재 세션에 추가되지 않은 확장 형식 데이터는 제거할 수 없습니다.
관련 링크
PowerShell