Install-Script

모듈:

PowerShellGet v3 Module

스크립트를 설치합니다.

구문

NameParameterSet (기본값)

Install-Script
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Scope <String>]
    [-NoPathUpdate]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObject

Install-Script
    [-InputObject] <PSObject[]>
    [-Scope <String>]
    [-NoPathUpdate]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

cmdlet은 Install-Script 리포지토리에서 스크립트 페이로드를 획득하고, 페이로드가 유효한 PowerShell 스크립트인지 확인하고, 스크립트 파일을 지정된 설치 위치에 복사합니다.

Install-PSResource의 cmdlet에 대한 프록시 cmdlet입니다. 자세한 내용은 Install-PSResource를 참조하세요.

예제

예제 1: 스크립트 찾기 및 설치

PS C:\> Find-Script -Repository "Local1" -Name "Required-Script2"
Version    Name                           Type       Repository           Description
-------    ----                           ----       ----------           -----------
2.5        Required-Script2               Script     local1               Description for the Required-Script2 script

PS C:\> Find-Script -Repository "Local1" -Name "Required-Script2" | Install-Script
PS C:\> Get-Command -Name "Required-Script2"
CommandType     Name                      Version    Source
-----------     ----                      -------    ------
ExternalScript  Required-Script2.ps1      2.0       C:\Users\pattif\Documents\WindowsPowerShell\Scripts\Required-Script2.ps1

PS C:\> Get-InstalledScript -Name "Required-Script2"
Version    Name                  Type     Repository           Description
-------    ----                  ----     ----------           -----------
2.5        Required-Script2      Script   local1               Description for the Required-Script2 script

PS C:\> Get-InstalledScript -Name "Required-Script2" | Format-List *
Name                       : Required-Script2
Version                    : 2.5
Type                       : Script
Description                : Description for the Required-Script2 script
Author                     : pattif
CompanyName                :
Copyright                  : 2015 Microsoft Corporation. All rights reserved.
PublishedDate              : 8/15/2015 12:42:39 AM
LicenseUri                 : http://required-script2.com/license
ProjectUri                 : http://required-script2.com/
IconUri                    : http://required-script2.com/icon
Tags                       : {Tag1, Tag2, Tag-Required-Script2-2.5, PSScript...}
Includes                   : {Function, DscResource, Cmdlet, Command}
PowerShellGetFormatVersion :
ReleaseNotes               : Required-Script2 release notes
Dependencies               : {}
RepositorySourceLocation   : http://pattif-dev:8765/api/v2/
Repository                 : local1
PackageManagementProvider  : NuGet
InstalledLocation          : C:\Users\pattif\Documents\WindowsPowerShell\Scripts

첫 번째 명령은 Local1 리포지토리에서 명명된 Required-Script2 스크립트를 찾아 결과를 표시합니다.

두 번째 명령은 스크립트를 Required-Script2 찾은 다음 파이프라인 연산자를 사용하여 cmdlet에 Install-Script 전달하여 설치합니다.

세 번째 명령은 cmdlet을 Get-Command 사용하여 가져와 Required-Script2결과를 표시합니다.

네 번째 명령은 cmdlet을 Get-InstalledScript 사용하여 결과를 가져와 Required-Script2 서 표시합니다.

다섯 번째 명령은 파이프라인 연산자를 가져오 Required-Script2 고 사용하여 cmdlet에 Format-List 전달하여 출력의 형식을 지정합니다.

예제 2: AllUsers 범위를 사용하여 스크립트 설치

PS C:\> Install-Script -Repository "Local1" -Name "Required-Script3" -Scope "AllUsers"
PS C:\> Get-InstalledScript -Name "Required-Script3"
Version    Name                  Type       Repository    Description
-------    ----                  ----       ----------    -----------
2.5        Required-Script3      Script     local1        Description for the Required-Script3 script

PS C:\> Get-InstalledScript -Name "Required-Script3" | Format-List *
Name                       : Required-Script3
Version                    : 2.5
Type                       : Script
Description                : Description for the Required-Script3 script
Author                     : pattif
CompanyName                :
Copyright                  : 2015 Microsoft Corporation. All rights reserved.
PublishedDate              : 8/15/2015 12:42:45 AM
LicenseUri                 : http://required-script3.com/license
ProjectUri                 : http://required-script3.com/
IconUri                    : http://required-script3.com/icon
Tags                       : {Tag1, Tag2, Tag-Required-Script3-2.5, PSScript...}
Includes                   : {Function, DscResource, Cmdlet, Command}
PowerShellGetFormatVersion :
ReleaseNotes               : Required-Script3 release notes
Dependencies               : {}
RepositorySourceLocation   : http://pattif-dev:8765/api/v2/
Repository                 : local1
PackageManagementProvider  : NuGet
InstalledLocation          : C:\Program Files\WindowsPowerShell\Scripts

첫 번째 명령은 명명 Required-Script3 된 스크립트를 설치하고 AllUsers 범위를 할당합니다.

두 번째 명령은 설치된 스크립트 Required-Script3 를 가져오고 해당 스크립트에 대한 정보를 표시합니다.

세 번째 명령은 파이프라인 연산자를 가져오 Required-Script3 고 사용하여 cmdlet에 Format-List 전달하여 출력의 형식을 지정합니다.

예제 3: 스크립트 및 해당 종속성 설치

PS C:\> Find-Script -Repository "Local1" -Name "Script-WithDependencies2" -IncludeDependencies
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.0        Script-WithDependencies2    Script     local1        Description for the Script-WithDependencies2 script
2.5        RequiredModule1             Module     local1        RequiredModule1 module
2.5        RequiredModule2             Module     local1        RequiredModule2 module
2.5        RequiredModule3             Module     local1        RequiredModule3 module
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script

PS C:\> Install-Script -Repository "Local1" -Name "Script-WithDependencies2"
PS C:\> Get-InstalledScript
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script
2.0        Script-WithDependencies2    Script     local1        Description for the Script-WithDependencies2 script

PS C:\> Get-InstalledModule
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        RequiredModule1             Module     local1        RequiredModule1 module
2.5        RequiredModule2             Module     local1        RequiredModule2 module
2.5        RequiredModule3             Module     local1        RequiredModule3 module

PS C:\> Find-Script -Repository "Local1" -Name "Required-Script*"
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script

PS C:\> Install-Script -Repository "Local1" -Name "Required-Script*"
PS C:\> Get-InstalledScript
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script

첫 번째 명령은 Local1 리포지토리에서 명명된 Script-WithDependencies2 스크립트와 해당 종속성을 찾아 결과를 표시합니다.

두 번째 명령이 설치됩니다.Script-WithDependencies2

세 번째 명령은 스크립트 cmdlet을 사용하여 Get-InstalledScript 설치된 스크립트를 가져와 결과를 표시합니다.

네 번째 명령은 cmdlet을 Get-InstalledModule 사용하여 설치된 모듈을 가져와 결과를 표시합니다.

다섯 번째 명령은 cmdlet을 Find-Script 사용하여 이름이 시작되는 스크립트를 찾고 결과를 표시합니다 Required-Script .

여섯 번째 명령은 Local1 리포지토리에서 이름이 시작되는 Required-Script 스크립트를 설치합니다.

최종 명령은 설치된 스크립트를 가져오고 결과를 표시합니다.

매개 변수

-AcceptLicense

모듈에 필요한 경우 설치 중에 라이선스 계약을 자동으로 수락합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-AllowPrerelease

시험판으로 표시된 스크립트를 설치할 수 있습니다.

프록시 cmdlet은 이 매개 변수를 .의 시험판 매개 변수에 매핑합니다 Install-PSResource.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

NameParameterSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Confirm

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

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	cf(cf)

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Credential

지정된 패키지 공급자 또는 원본에 대한 스크립트를 설치할 수 있는 권한이 있는 사용자 계정을 지정합니다.

매개 변수 속성

형식:	PSCredential
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-Force

프록시 cmdlet은 이 매개 변수가 지원 Install-PSResource되지 않으므로 무시합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-InputObject

파이프라인 입력에 사용됩니다. InputObject에 직접 제공된 값이 있으면 오류가 throw됩니다. 파이프라인을 사용하여 InputObject 매개 변수를 사용하여 개체를 전달합니다.

매개 변수 속성

형식:	PSObject[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

InputObject

Position:	0
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-MaximumVersion

프록시 cmdlet은 이 매개 변수의 값을 사용하여 Version 매개 변수 Install-PSResource와 함께 사용할 NuGet 버전 검색 문자열을 만듭니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

NameParameterSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-MinimumVersion

프록시 cmdlet은 이 매개 변수의 값을 사용하여 Version 매개 변수 Install-PSResource와 함께 사용할 NuGet 버전 검색 문자열을 만듭니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

NameParameterSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-Name

설치할 스크립트 이름의 배열을 지정합니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

NameParameterSet

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-NoPathUpdate

프록시 cmdlet은 이 매개 변수가 지원 Install-PSResource되지 않으므로 무시합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PassThru

PassThru 매개 변수 Install-Script 를 사용하는 경우 모듈에 대한 PSRepositoryItemInfo 개체를 출력합니다. cmdlet에서 Find-Script 가져오는 것과 동일한 정보입니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Proxy

프록시 cmdlet은 이 매개 변수가 지원 Install-PSResource되지 않으므로 무시합니다.

매개 변수 속성

형식:	Uri
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-ProxyCredential

프록시 cmdlet은 이 매개 변수가 지원 Install-PSResource되지 않으므로 무시합니다.

매개 변수 속성

형식:	PSCredential
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-Repository

cmdlet에 등록된 Register-PSRepository 리포지토리의 이름을 지정합니다. 기본값은 등록된 모든 리포지토리입니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

NameParameterSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-RequiredVersion

프록시 cmdlet은 이 매개 변수의 값을 사용하여 Version 매개 변수 Install-PSResource와 함께 사용할 NuGet 버전 검색 문자열을 만듭니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

NameParameterSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-Scope

스크립트의 설치 범위를 지정합니다. 유효한 값은 AllUsers 및 CurrentUser입니다.

AllUsers 범위를 사용하면 컴퓨터 $env:ProgramFiles\WindowsPowerShell\Scripts의 모든 사용자가 액세스할 수 있는 위치에 모듈을 설치할 수 있습니다.

CurrentUser 범위를 사용하면 모듈을 현재 사용자만 사용할 수 있도록 모듈만 $HOME\Documents\WindowsPowerShell\Scripts설치할 수 있습니다.

범위가 정의되지 않은 경우 기본값은 현재 세션에 따라 설정됩니다.

• 관리자 권한 PowerShell 세션의 경우 범위 는 기본적으로 AllUsers로 설정됩니다.
• PowerShellGet 버전 2.0.0 이상의 승격되지 않은 PowerShell 세션의 경우 범위는 CurrentUser입니다.
• PowerShellGet 버전 1.6.7 이하의 승격되지 않은 PowerShell 세션의 경우 범위 가 정의되지 않고 Install-Module 실패합니다.

매개 변수 속성

형식:	String
Default value:	None
허용되는 값:	CurrentUser, AllUsers
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	위스콘신

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

String

PSObject

String

Uri

PSCredential

출력

Object

참고

중요합니다

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

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

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

관련 링크

• Find-Script
• Publish-Script
• Save-Script
• Uninstall-Script
• Update-Script