다음을 통해 공유


Uninstall-PSResource

PowerShellGet을 사용하여 설치된 리소스를 제거합니다.

Syntax

Uninstall-PSResource
         [-Name] <String[]>
         [-Version <String>]
         [-Prerelease]
         [-SkipDependencyCheck]
         [-Scope <ScopeType>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-PSResource
         [-Prerelease]
         [-InputObject] <PSResourceInfo[]>
         [-SkipDependencyCheck]
         [-Scope <ScopeType>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Description

이 cmdlet은 PowerShellGet v2의 Uninstall-ModuleUninstall-Script cmdlet 기능을 결합합니다. cmdlet은 패키지 설치 경로에서 PowerShellGet XML 메타데이터 파일이 있는 리소스를 검색합니다. 일치하는 리소스는 시스템에서 제거됩니다.

기본적으로 cmdlet은 제거되는 리소스가 다른 리소스에 대한 종속성인지 여부를 확인합니다.

예제

예 1

최신 버전의 Az 모듈을 제거합니다.

Uninstall-PSResource Az

예제 2

특정 버전의 Az 모듈을 제거합니다.

Uninstall-PSResource -name Az -version "5.0.0"

예제 3

지정된 버전 범위 내에서 모든 버전의 Az 모듈을 제거합니다.

Uninstall-PSResource -name Az -version "(5.0.0, 7.5.0)"

예제 4

이 예제에서는 다음 버전의 Az 모듈이 이미 설치되어 있다고 가정합니다.

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

cmdlet은 Uninstall-PSResource 지정된 버전 범위에 속하는 안정 및 시험판 버전을 제거합니다. NuGetVersion 규칙에 따라 시험판 버전은 안정적인 버전보다 작으므로 4.0.1-preview는 실제로 지정된 범위의 4.0.1 버전보다 작습니다. 따라서 4.0.1-preview는 제거되지 않습니다. 버전 4.1.0 및 4.0.2-preview는 범위에 속하므로 제거됩니다.

Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]"

예제 5

이 예제에서는 다음 버전의 Az 모듈이 이미 설치되어 있다고 가정합니다.

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

Prerelease 매개 변수를 제외하면 이전 예제와 동일하며 시험판 버전만 제거됩니다. 버전 4.0.1-preview가 범위를 벗어나고 버전 4.1.0이 시험판 버전이 아니므로 버전 4.0.2-preview만 제거됩니다.

Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]" -Prerelease

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

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

-InputObject

파이프라인 입력에 사용됩니다.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

제거할 리소스 또는 리소스의 이름입니다. 와일드카드는 지원되지만 NuGet은 문자만 허용합니다 * .

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

-Prerelease

시험판 버전 리소스만 제거해야 했음을 나타냅니다.

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

-Scope

제거할 리소스의 scope 지정합니다.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

기본적으로 cmdlet은 제거되는 리소스가 다른 리소스에 대한 종속성인지 여부를 확인합니다. 이 매개 변수를 사용하면 종속성 테스트가 건너뜁니다.

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

-Version

제거할 리소스의 버전을 지정합니다. 값은 NuGet 버전 관리 구문을 사용하여 정확한 버전 또는 버전 범위일 수 있습니다.

NuGet 버전 범위에 대한 자세한 내용은 패키지 버전 관리를 참조하세요.

PowerShellGet은 NuGet 버전 범위 설명서에 나열된 최소 포괄 버전을 제외한 모든 버전을 지원합니다. 을 버전으로 사용하면 1.0.0.0 버전 1.0.0.0 이상(최소 포함 범위)이 생성되지 않습니다. 대신 값은 필수 버전으로 간주됩니다. 최소 포함 범위를 검색하려면 를 버전 범위로 사용합니다 [1.0.0.0, ] .

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

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

출력

Object