Install-Script
스크립트를 설치합니다.
구문
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>]Install-Script
[-InputObject] <PSObject[]>
[-Scope <String>]
[-NoPathUpdate]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AcceptLicense]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
cmdlet은 Install-Script 리포지토리에서 스크립트 페이로드를 획득하고, 페이로드가 유효한 PowerShell 스크립트인지 확인하고, 스크립트 파일을 지정된 설치 위치에 복사합니다.
Microsoft.PowerShell.PSResourceGet의 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 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AllowPrerelease
시험판으로 표시된 스크립트를 설치할 수 있습니다.
프록시 cmdlet은 이 매개 변수를 .의 시험판 매개 변수에 매핑합니다 Install-PSResource.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Credential
지정된 패키지 공급자 또는 원본에 대한 스크립트를 설치할 수 있는 권한이 있는 사용자 계정을 지정합니다.
| 형식: | PSCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Force
프록시 cmdlet은 이 매개 변수가 지원 Install-PSResource되지 않으므로 무시합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
파이프라인 입력에 사용됩니다. InputObject에 직접 제공된 값이 있으면 오류가 throw됩니다. 파이프라인을 사용하여 InputObject 매개 변수를 사용하여 개체를 전달합니다.
| 형식: | PSObject[] |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-MaximumVersion
프록시 cmdlet은 이 매개 변수의 값을 사용하여 Version 매개 변수 Install-PSResource와 함께 사용할 NuGet 버전 검색 문자열을 만듭니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-MinimumVersion
프록시 cmdlet은 이 매개 변수의 값을 사용하여 Version 매개 변수 Install-PSResource와 함께 사용할 NuGet 버전 검색 문자열을 만듭니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Name
설치할 스크립트 이름의 배열을 지정합니다.
| 형식: | String[] |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-NoPathUpdate
프록시 cmdlet은 이 매개 변수가 지원 Install-PSResource되지 않으므로 무시합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PassThru
PassThru 매개 변수 Install-Script 를 사용하는 경우 모듈에 대한 PSRepositoryItemInfo 개체를 출력합니다. cmdlet에서 Find-Script 가져오는 것과 동일한 정보입니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Proxy
프록시 cmdlet은 이 매개 변수가 지원 Install-PSResource되지 않으므로 무시합니다.
| 형식: | Uri |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ProxyCredential
프록시 cmdlet은 이 매개 변수가 지원 Install-PSResource되지 않으므로 무시합니다.
| 형식: | PSCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Repository
cmdlet에 등록된 Register-PSRepository 리포지토리의 이름을 지정합니다. 기본값은 등록된 모든 리포지토리입니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RequiredVersion
프록시 cmdlet은 이 매개 변수의 값을 사용하여 Version 매개 변수 Install-PSResource와 함께 사용할 NuGet 버전 검색 문자열을 만듭니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | 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 |
| 허용되는 값: | CurrentUser, AllUsers |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
String[]
PSObject[]
출력
참고
중요합니다
2020년 4월부터 PowerShell 갤러리는 더 이상 TLS(전송 계층 보안) 버전 1.0 및 1.1을 지원하지 않습니다. TLS 1.2 이상을 사용하지 않는 경우 PowerShell 갤러리에 액세스하려고 할 때 오류가 발생합니다. 다음 명령을 사용하여 TLS 1.2를 사용하고 있는지 확인합니다.
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
자세한 내용은 PowerShell 블로그의 공지 참조하세요.
