Share via

Remove-TypeData

  • 참조
모듈:
Microsoft.PowerShell.Utility

현재 세션에서 확장 유형을 삭제합니다.

Syntax

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-TypeDataRemove-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을 실행하기 전에 확인 메시지가 표시됩니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

이 cmdlet이 세션 확장 형식 데이터에서 삭제하는 파일 배열을 지정합니다. 이 매개 변수는 필수입니다.

하나 이상의 Types.ps1xml 파일의 경로 및 파일 이름을 입력합니다. 와일드카드는 지원되지 않습니다. 경로를 생략하면 기본 위치는 현재 디렉터리입니다.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TypeData

이 cmdlet이 세션에서 삭제하는 형식 데이터를 지정합니다. 이 매개 변수는 필수입니다. 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

이 cmdlet이 모든 확장 형식 데이터를 삭제하는 형식을 지정합니다. 시스템 네임스페이스의 형식에 대해 짧은 이름을 입력합니다. 그렇지 않으면 전체 형식 이름이 필요합니다. 와일드카드는 지원되지 않습니다.

형식 이름을 .에 파이프할 Remove-TypeData수 있습니다. 개체를 파이프할 Remove-TypeDataRemove-TypeData 때 개체의 형식 이름을 가져오고 개체 형식에 대한 모든 형식 데이터를 제거합니다.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

TypeData

cmdlet이 반환하는 개체와 같은 TypeData 개체를 Get-TypeData 이 cmdlet으로 파이프할 수 있습니다.

String

형식 이름을 포함하는 문자열을 이 cmdlet으로 파이프할 수 있습니다. 개체를 이 cmdlet으로 파이프하면 개체의 형식 이름을 가져오고 개체 형식에 대한 모든 형식 데이터를 제거합니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.

참고

Remove-TypeData 는 현재 세션에서 확장 형식 데이터만 제거할 수 있습니다. 컴퓨터에 있지만 현재 세션으로 가져오지 않은 모듈에 정의된 확장 형식과 같이 현재 세션에 추가되지 않은 확장 형식 데이터는 제거할 수 없습니다.