다음을 통해 공유


Install-PSResource

등록된 리포지토리에서 리소스를 설치합니다.

구문

Install-PSResource
       [-Name] <String[]>
       [-Version <String>]
       [-Prerelease]
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-InputObject] <PSResourceInfo[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResourceFile <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResource <Object>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

이 cmdlet은 등록된 리포지토리에서 컴퓨터의 설치 경로로 리소스를 설치합니다. 기본적으로 cmdlet은 개체를 반환하지 않습니다. 다른 매개 변수를 사용하면 리소스에 대한 리포지토리, 범위 및 버전을 지정하고 라이선스 프롬프트를 표시하지 않을 수 있습니다.

이 cmdlet은 PowerShellGet v2의 Install-Module cmdlet 및 Install-Script 함수를 결합합니다.

Install-PSResource 는 새로 설치된 모듈을 현재 세션에 로드하지 않습니다. 업데이트된 모듈을 사용하려면 새 버전을 가져오거나 새 세션을 시작해야 합니다. 자세한 내용은 Import-Module을 참조 하세요.

예제

예 1

Az 모듈의 안정적인 최신(시험판이 아닌) 버전을 설치합니다.

Install-PSResource Az

예제 2

버전 간에 안정적인 최신 Az 모듈을 설치합니다8.3.0.7.3.0

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

예 3

안정적인 최신 버전의 Az 모듈을 설치합니다. 다시 설치 매개 변수를 사용하는 경우 cmdlet은 이전에 설치된 모든 버전에 대해 씁니다.

Install-PSResource Az -Reinstall

예시 4

psd1 파일에 지정된 PSResources를 설치합니다.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

예시 5

해시 테이블의 PSResources를 설치합니다.

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

매개 변수

-AcceptLicense

리소스가 사용권 계약에 동의하라는 요청을 수락하도록 지정합니다. 이렇게 하면 모듈에서 사용자가 사용권 계약에 동의하도록 요구하는지 묻는 메시지가 표시되지 않습니다.

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AuthenticodeCheck

Windows에서 Authenticode 서명 및 카탈로그 파일의 유효성을 검사합니다.

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Credential

리포지토리에 액세스할 때 사용되는 선택적 자격 증명입니다.

형식:PSCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

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

형식:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
별칭:ParentResource
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

설치할 하나 이상의 리소스 이름입니다.

형식:String[]
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-NoClobber

컴퓨터에 이미 있는 cmdlet이 포함된 패키지를 설치할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

지정하면 저장된 리소스에 대한 PSResourceInfo 개체를 출력합니다.

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Prerelease

지정하면 반환된 검색 결과에 시험판 버전이 포함됩니다.

형식:SwitchParameter
별칭:IsPrerelease
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Quiet

설치 진행률 표시줄을 표시하지 않습니다.

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Reinstall

최신 버전이 이미 설치된 경우에도 최신 버전의 모듈을 설치합니다. 설치된 버전을 덮어씁니다. 이렇게 하면 모듈의 손상된 설치를 복구할 수 있습니다.

이전 버전의 모듈이 설치된 경우 새 버전별 폴더에 새 버전이 나란히 설치됩니다.

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Repository

검색할 리포지토리 이름을 하나 이상 지정합니다. 지정하지 않으면 패키지가 포함된 리포지토리를 찾을 때까지 검색에 등록된 모든 리포지토리가 우선 순위 순서(가장 높은 우선 순위)로 포함됩니다. 리포지토리는 우선 순위별로 정렬된 다음 이름으로 정렬됩니다. 우선 순위 값이을수록 우선 순위가 높습니다.

여러 리포지 토리에서 리소스를 검색할 때 PSResourceGet cmdlet은 이 정렬 순서를 사용하여 리포지토리를 검색합니다. Install-PSResource 는 정렬된 리포지토리 목록에서 일치하는 첫 번째 패키지를 설치합니다.

매개 변수는 와일드카드 문자를 지원합니다 * . 여러 리포지토리를 지정하는 경우 모든 이름에 와일드카드 문자가 포함되거나 생략되어야 합니다. 와일드카드를 사용 또는 사용하지 않고는 이름의 혼합을 지정할 수 없습니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:True

-RequiredResource

설치할 리소스를 지정하는 해시 테이블 또는 JSON 문자열입니다. 와일드카드 문자는 허용되지 않습니다. 파일 형식에 대한 설명은 NOTES 섹션을 참조하세요.

형식:Object
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RequiredResourceFile

설치할 리소스를 .psd1 지정하는 경로입니다 .json . 와일드카드 문자는 허용되지 않습니다. 파일 형식에 대한 설명은 NOTES 섹션을 참조하세요.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Scope

설치 범위를 지정합니다. 허용되는 값은 다음과 같습니다.

  • CurrentUser
  • AllUsers

기본 범위는 설치에 대한 권한 상승이 필요하지 않은 범위입니다 CurrentUser.

범위는 AllUsers 컴퓨터의 모든 사용자가 액세스할 수 있는 위치에 모듈을 설치합니다. 예시:

  • $env:ProgramFiles\PowerShell\Modules

컴퓨터 CurrentUser 의 현재 사용자만 액세스할 수 있는 위치에 모듈을 설치합니다. 예시:

  • $home\Documents\PowerShell\Modules
형식:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
허용되는 값:CurrentUser, AllUsers
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SkipDependencyCheck

리소스 종속성 확인을 건너뜁니다. 찾은 리소스만 설치됩니다. 찾은 리소스의 리소스가 설치되지 않습니다.

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-TemporaryPath

실제 설치 전에 리소스를 일시적으로 설치하는 경로를 지정합니다. 임시 경로가 제공되지 않으면 리소스가 현재 사용자의 임시 폴더에 일시적으로 설치됩니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-TrustRepository

리포지토리를 신뢰하라는 프롬프트를 표시하지 않습니다. 신뢰 리포지토리에 대한 프롬프트는 리포지토리가 신뢰할 수 있는 것으로 구성되지 않은 경우에만 발생합니다.

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Version

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

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

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:True

-WhatIf

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

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

출력

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

기본적으로 cmdlet은 개체를 반환하지 않습니다. PassThru 매개 변수를 사용하면 cmdlet은 저장된 리소스에 대한 PSResourceInfo 개체를 출력합니다.

참고

모듈은 에 isres 대한 Install-PSResource별칭으로 정의됩니다.

RequiredResource 및 RequiredResourceFile 매개 변수는 특정 조건과 일치하는 PSResource 개체를 찾는 데 사용됩니다. 해시 테이블 또는 JSON 개체를 사용하여 검색 조건을 지정할 수 있습니다. RequiredResourceFile 매개 변수의 경우 해시 테이블은 파일에 저장 .psd1 되고 JSON 개체는 파일에 저장됩니다.json. 자세한 내용은 about_PSResourceGet 참조하세요.