Install-Package

참조

모듈:: PackageManagement

하나 이상의 소프트웨어 패키지를 설치합니다.

Syntax

Install-Package
       [-Name] <String[]>
       [-RequiredVersion <String>]
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-Source <String[]>]
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ProviderName <String[]>]
       [<CommonParameters>]

Install-Package
       [-InputObject] <SoftwareIdentity[]>
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]

Description

cmdlet은 Install-Package 로컬 컴퓨터에 하나 이상의 소프트웨어 패키지를 설치합니다. 여러 소프트웨어 원본이 있는 경우 및 Get-PackageSource 를 사용하여 Get-PackageProvider 공급자에 대한 세부 정보를 표시합니다.

중요

PackageManagement 모듈에 포함된 명령은 Visual Studio의 패키지 관리자 콘솔에서 NuGet 모듈에서 제공하는 명령과 다릅니다. 각 모듈에는 다른 모듈에서 사용할 수 없는 명령이 있습니다. 이름이 같은 명령은 특정 인수와 다릅니다. 자세한 내용은 Visual Studio의 패키지 관리자 콘솔에 대한 PowerShell 참조 설명서를 참조하세요.

예제

예제 1: 패키지 이름으로 패키지 설치

cmdlet은 Install-Package 소프트웨어 패키지 및 해당 종속성을 설치합니다.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUser

Install-Package 는 매개 변수를 사용하여 패키지 이름 및 원본을 지정합니다. Credential 매개 변수는 패키지를 설치할 수 있는 권한이 있는 도메인 사용자 계정을 사용합니다. 명령은 사용자 계정 암호를 묻는 메시지를 표시합니다.

예제 2: Find-Package 사용하여 패키지 설치

이 예제에서 에서 반환 Find-Package 된 개체는 파이프라인 아래로 전송되고 에 의해 Install-Package설치됩니다.

PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package

Find-Package 는 이름 및 원본 매개 변수를 사용하여 패키지를 찾습니다. 개체는 파이프라인 아래로 전송되고 Install-Package 로컬 컴퓨터에 패키지를 설치합니다.

예제 3: 버전 범위를 지정하여 패키지 설치

Install-Package 에서는 MinimumVersion 및 MaximumVersion 매개 변수를 사용하여 소프트웨어 버전 범위를 지정합니다.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0

Install-Package 는 이름 및 원본 매개 변수를 사용하여 패키지를 찾습니다. MinimumVersion 및 MaximumVersion 매개 변수는 소프트웨어 버전 범위를 지정합니다. 범위에서 가장 높은 버전이 설치됩니다.

매개 변수

-AcceptLicense

AcceptLicense 는 설치 중에 라이선스 계약을 자동으로 수락합니다.

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

-AllowClobber

기존 명령과의 충돌에 대한 경고 메시지를 재정의합니다. 설치 중인 명령과 이름이 같은 기존 명령을 덮어씁니다.

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

-AllowPrereleaseVersions

시험판으로 표시된 패키지를 설치할 수 있습니다.

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

-AllVersions

Install-Package 는 패키지의 사용 가능한 모든 버전을 설치합니다. 기본적으로 최신 버전만 설치됩니다.

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

-Command

검색하는 하나 이상의 명령을 지정합니다 Install-Package .

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

-ConfigFile

구성 파일이 포함된 경로를 지정합니다.

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

-Confirm

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

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

-Contains

Install-PackageContains 매개 변수가 개체의 속성 값과 일치하는 값을 지정하는 경우 개체를 가져옵니다.

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

-Credential

컴퓨터에 액세스하고 명령을 실행할 수 있는 권한이 있는 사용자 계정을 지정합니다. User01, Domain01\User01과 같은 사용자 이름을 입력하거나 cmdlet에서 생성된 PSCredential 개체를 Get-Credential 입력합니다. 사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다.

Credential 매개 변수를 지정 Install-Package 하지 않으면 현재 사용자를 사용합니다.

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

-Destination

입력 개체의 경로를 지정합니다.

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

-DscResource

에서 검색하는 하나 이상의 DSC(Desired State Configuration) 리소스를 Install-Package지정합니다. cmdlet을 Find-DscResource 사용하여 DSC 리소스를 찾습니다.

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

-ExcludeVersion

폴더 경로에서 버전 번호를 제외하려면 전환합니다.

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

-Filter

이름 및 설명 속성 내에서 검색할 용어를 지정합니다.

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

-FilterOnTag

결과를 필터링하고 지정된 태그를 포함하지 않는 결과를 제외하는 태그를 지정합니다.

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

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다. 보안을 제외하고 성공하지 못하게 Install-Package 하는 제한을 재정의합니다.

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

-ForceBootstrap

PackageManagement가 지정된 패키지에 대한 패키지 공급자를 자동으로 설치하도록 합니다.

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

-Headers

패키지 헤더를 지정합니다.

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

-Includes

모든 패키지 형식을 찾을지 여부를 Install-Package 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

Cmdlet
DscResource
함수
RoleCapability
워크플로

Type:	String[]
Accepted values:	Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

파이프라인 입력을 허용합니다. 패키지의 SoftwareIdentity 형식을 사용하여 패키지를 지정합니다. Find-Package 는 SoftwareIdentity 개체를 출력합니다.

Type:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InstallUpdate

업데이트를 설치한다는 것을 Install-Package 나타냅니다.

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

-MaximumVersion

설치할 최대 허용 패키지 버전을 지정합니다. 이 매개 변수 Install-Package 를 지정하지 않으면 패키지의 최신 버전을 설치합니다.

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

-MinimumVersion

설치할 최소 허용 패키지 버전을 지정합니다. 이 매개 변수를 추가하지 않으면 MaximumVersion 매개 변수 Install-Package 로 지정된 버전을 충족하는 패키지의 최신 버전을 설치합니다.

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

-Name

하나 이상의 패키지 이름을 지정합니다. 여러 패키지 이름은 쉼표로 구분해야 합니다.

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

-NoPathUpdate

NoPathUpdate 는 cmdlet에 Install-Script 만 적용됩니다. NoPathUpdate 는 공급자가 추가한 동적 매개 변수이며 에서 Install-Package지원되지 않습니다.

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

-PackageManagementProvider

PackageManagement 공급자의 이름을 지정합니다.

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

-ProviderName

패키지 검색을 scope 하나 이상의 패키지 공급자 이름을 지정합니다. Get-PackageProvider cmdlet을 실행하여 패키지 공급자 이름을 가져올 수 있습니다.

Type:	String[]
Aliases:	Provider
Accepted values:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

인터넷 리소스에 직접 연결하는 대신 요청에 대한 프록시 서버를 지정합니다.

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

-ProxyCredential

Proxy 매개 변수로 지정된 프록시 서버를 사용할 수 있는 권한이 있는 사용자 계정을 지정합니다.

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

-PublishLocation

패키지의 게시된 위치에 대한 경로를 지정합니다.

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

-RequiredVersion

설치하려는 패키지의 정확한 허용 버전을 지정합니다. 이 매개 변수를 추가하지 않으면 MaximumVersion 매개 변수 Install-Package 로 지정된 버전을 충족하는 패키지의 최신 버전을 설치합니다.

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

-RoleCapability

역할 기능의 배열을 지정합니다.

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

-Scope

패키지를 설치할 scope 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

CurrentUser
AllUsers

Type:	String
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptPublishLocation

스크립트의 게시된 위치에 대한 경로를 지정합니다.

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

-ScriptSourceLocation

스크립트 원본 위치를 지정합니다.

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

-SkipDependencies

소프트웨어 종속성 설치를 건너뜁니다.

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

-SkipPublisherCheck

설치된 버전보다 최신 패키지 버전을 가져올 수 있습니다. 예를 들어 신뢰할 수 있는 게시자가 디지털 서명했지만 새 버전이 디지털 서명되지 않은 설치된 패키지입니다.

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

-SkipValidate

패키지의 자격 증명 유효성 검사를 건너뛰는 스위치입니다.

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

-Source

하나 이상의 패키지 원본을 지정합니다. 여러 패키지 원본 이름은 쉼표로 구분해야 합니다. cmdlet을 실행 Get-PackageSource 하여 패키지 원본 이름을 가져올 수 있습니다.

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

-Tag

패키지 메타데이터에서 검색할 하나 이상의 문자열을 지정합니다.

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

-Type

모듈, 스크립트 또는 둘 다로 패키지를 검색할지 여부를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

모듈
스크립트
모두

Type:	String
Accepted values:	Module, Script, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

cmdlet이 실행될 경우 Install-Package 어떤 일이 발생하는지 표시합니다. cmdlet은 실행되지 않습니다.

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

입력

Microsoft.PackageManagement.Packaging.SoftwareIdentity

SoftwareIdentity 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

Microsoft.PackageManagement.Packaging.SoftwareIdentity

이 cmdlet은 설치하는 각 패키지에 대해 SoftwareIdentity 개체를 반환합니다.

참고

명령에 패키지 공급자를 포함하면 cmdlet에서 동적 매개 변수를 사용할 수 있습니다. 동적 매개 변수는 패키지 공급자와 관련이 있습니다. cmdlet은 Get-Help cmdlet의 매개 변수 집합을 나열하고 공급자의 매개 변수 집합을 포함합니다. 예를 들어 Install-Package 에는 , AllowClobber및 SkipPublisherCheck를 포함하는 -NoPathUpdatePowerShellGet 매개 변수 집합이 있습니다.

중요

2020년 4월부터 PowerShell 갤러리는 더 이상 TLS(전송 계층 보안) 버전 1.0 및 1.1을 지원하지 않습니다. TLS 1.2 이상을 사용하지 않을 경우 PowerShell 갤러리에 액세스하려고 하면 오류가 표시됩니다. 다음 명령을 사용하여 TLS 1.2를 사용하는지 확인합니다.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

자세한 내용은 PowerShell 블로그의 공지를 참조하세요.

다음을 통해 공유

Install-Package

Syntax

Description

예제

예제 1: 패키지 이름으로 패키지 설치

예제 2: Find-Package 사용하여 패키지 설치

예제 3: 버전 범위를 지정하여 패키지 설치

매개 변수

-AcceptLicense

-AllowClobber

-AllowPrereleaseVersions

-AllVersions

-Command

-ConfigFile

-Confirm

-Contains

-Credential

-Destination

-DscResource

-ExcludeVersion

-Filter

-FilterOnTag

-Force

-ForceBootstrap

-Headers

-Includes

-InputObject

-InstallUpdate

-MaximumVersion

-MinimumVersion

-Name

-NoPathUpdate

-PackageManagementProvider

-ProviderName

-Proxy

-ProxyCredential

-PublishLocation

-RequiredVersion

-RoleCapability

-Scope

-ScriptPublishLocation

-ScriptSourceLocation

-SkipDependencies

-SkipPublisherCheck

-SkipValidate

-Source

-Tag

-Type

-WhatIf

입력

출력

참고

관련 링크

추가 리소스