다음을 통해 공유

Install-PSResource

  • 참조
모듈:
Microsoft.PowerShell.PSResourceGet

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

Syntax

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은 개체를 반환하지 않습니다. 다른 매개 변수를 사용하면 리소스에 대한 리포지토리, scope 및 버전을 지정하고 라이선스 프롬프트를 표시하지 않을 수 있습니다.

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

예제

예 1

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

Install-PSResource Az

예제 2

버전 7.3.0 과 8.3.0사이의 에 안정적인 최신 Az 모듈을 설치합니다.

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

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

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

-AuthenticodeCheck

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

Type:SwitchParameter
Position:Named
Default value:False
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

-Credential

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

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

-InputObject

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

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

-Name

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

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

-NoClobber

컴퓨터에 이미 있는 cmdlet이 포함된 패키지를 설치하지 않도록 합니다.

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

-PassThru

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

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

-Prerelease

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

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

-Quiet

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

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

-Reinstall

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

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

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

-Repository

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

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

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

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

-RequiredResource

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

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

-RequiredResourceFile

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

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

-Scope

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

  • CurrentUser
  • AllUsers

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

AllUsers scope 컴퓨터의 모든 사용자가 액세스할 수 있는 위치에 모듈을 설치합니다. 예를 들면 다음과 같습니다.

  • $env:ProgramFiles\PowerShell\Modules

는 CurrentUser 컴퓨터의 현재 사용자만 액세스할 수 있는 위치에 모듈을 설치합니다. 예를 들면 다음과 같습니다.

  • $home\Documents\PowerShell\Modules
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

리소스 종속성에 대한 검사 건너뜁니다. 찾은 리소스만 설치됩니다. 찾은 리소스의 리소스가 설치되지 않습니다.

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

-TemporaryPath

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

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

-TrustRepository

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

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:True
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[]

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 참조하세요.