Save-Module

모듈:

PowerShellGet Module

로컬 컴퓨터에 모듈 및 해당 종속성을 저장하지만 모듈을 설치하지는 않습니다.

구문

NameAndPathParameterSet (기본값)

Save-Module
    [-Name] <String[]>
    [-Path] <String>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NameAndLiteralPathParameterSet

Save-Module
    [-Name] <String[]>
    -LiteralPath <String>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectAndLiteralPathParameterSet

Save-Module
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectAndPathParameterSet

Save-Module
    [-InputObject] <PSObject[]>
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Save-Module cmdlet은 등록된 리포지토리에서 모듈 및 모든 종속성을 다운로드합니다. Save-Module 최신 버전의 모듈을 다운로드하고 저장합니다. 파일은 로컬 컴퓨터의 지정된 경로에 저장됩니다. 모듈은 설치되어 있지 않지만 관리자는 내용을 검사할 수 있습니다. 그런 다음 저장된 모듈을 오프라인 컴퓨터의 적절한 $env:PSModulePath 위치에 복사할 수 있습니다.

Get-PSRepository 로컬 컴퓨터의 등록된 리포지토리를 표시합니다. Find-Module cmdlet을 사용하여 등록된 리포지토리를 검색할 수 있습니다.

모듈 버전 번호를 사용하는 매개 변수에는 버전 번호로 형식이 지정된 문자열이 필요합니다.

• 표준 버전 번호에는 x, y 및 z가 x.y.z 숫자인 형식이 있습니다.
• 시험판 버전에는 해당 릴리스에 x.y.z-<prerelease_label> 임의의 문자열이 할당된 형식 <prerelease_label> 이 있습니다.

예제

예제 1: 모듈 저장

이 예제에서는 모듈 및 해당 종속성이 로컬 컴퓨터에 저장됩니다.

Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery
Get-ChildItem -Path C:\Test\Modules

    Directory: C:\Test\Modules

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:31                PackageManagement
d-----         7/1/2019     13:31                PowerShellGet

Name 매개 변수를 사용하여 PowerShellGet모듈을 지정합니다. Path 매개 변수는 다운로드한 모듈을 저장할 위치를 지정합니다. 리포지토리 매개 변수는 등록된 리포지토리 PSGallery지정합니다. 다운로드가 완료되면 Get-ChildItem 파일이 저장되는 경로 내용을 표시합니다.

예제 2: 특정 버전의 모듈 저장

이 예제에서는 MaximumVersion같은 매개 변수를 사용하거나 RequiredVersion 모듈 버전을 지정하는 방법을 보여 줍니다.

Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery -MaximumVersion 2.1.0
Get-ChildItem -Path C:\Test\Modules\PowerShellGet\

    Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:40                2.1.0

Name 매개 변수를 사용하여 PowerShellGet모듈을 지정합니다. Path 매개 변수는 다운로드한 모듈을 저장할 위치를 지정합니다. 리포지토리 매개 변수는 등록된 리포지토리 PSGallery지정합니다. MaximumVersion 버전 2.1.0 다운로드하여 저장되도록 지정합니다. 다운로드가 완료되면 Get-ChildItem 파일이 저장되는 경로 내용을 표시합니다.

예제 3: 특정 버전의 모듈 찾기 및 저장

이 예제에서는 필요한 모듈 버전이 리포지토리에 있으며 로컬 컴퓨터에 저장됩니다.

Find-Module -Name PowerShellGet -Repository PSGallery -RequiredVersion 1.6.5 |
  Save-Module -Path C:\Test\Modules
Get-ChildItem -Path C:\Test\Modules\PowerShellGet

    Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     14:04                1.6.5

Name 매개 변수를 사용하여 PowerShellGet모듈을 지정합니다. 리포지토리 매개 변수는 등록된 리포지토리 PSGallery지정합니다. RequiredVersion 버전 1.6.5지정합니다.

개체가 Save-Module로 전달되며 파이프라인 아래로 보내집니다. Path 매개 변수는 다운로드한 모듈을 저장할 위치를 지정합니다. 다운로드가 완료되면 Get-ChildItem 파일이 저장되는 경로 내용을 표시합니다.

매개 변수

-AcceptLicense

패키지에 필요한 경우 사용권 계약에 자동으로 동의합니다.

매개 변수 속성

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

매개 변수 집합

(All)

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

-AllowPrerelease

시험판으로 표시된 모듈을 저장할 수 있습니다.

매개 변수 속성

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

매개 변수 집합

NameAndPathParameterSet

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

NameAndLiteralPathParameterSet

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

-Confirm

Save-Module실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:	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

Path 매개 변수에 지정된 위치가 없으면 cmdlet은 오류를 반환합니다. Force 매개 변수를 사용하면 대상 경로가 만들어집니다.

매개 변수 속성

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

매개 변수 집합

(All)

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

-InputObject

PSRepositoryItemInfo 개체를 허용합니다. 예를 들어 출력은 변수에 Find-Module 해당 변수를 InputObject 인수로 사용합니다.

매개 변수 속성

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

매개 변수 집합

InputObjectAndLiteralPathParameterSet

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

InputObjectAndPathParameterSet

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

-LiteralPath

하나 이상의 위치에 대한 경로를 지정합니다. LiteralPath 매개 변수의 값은 입력한 대로 정확하게 사용됩니다. 와일드카드로 해석되는 문자는 없습니다. 경로에 이스케이프 문자가 포함된 경우 작은따옴표로 묶습니다. PowerShell은 작은따옴표로 묶인 문자를 이스케이프 시퀀스로 해석하지 않습니다.

매개 변수 속성

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

매개 변수 집합

NameAndLiteralPathParameterSet

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

InputObjectAndLiteralPathParameterSet

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

-MaximumVersion

저장할 모듈의 최대 또는 최신 버전을 지정합니다. MaximumVersion 및 RequiredVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.

매개 변수 속성

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

매개 변수 집합

NameAndPathParameterSet

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

NameAndLiteralPathParameterSet

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

-MinimumVersion

저장할 단일 모듈의 최소 버전을 지정합니다. 여러 모듈을 설치하려는 경우 이 매개 변수를 추가할 수 없습니다. MinimumVersion 및 RequiredVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.

매개 변수 속성

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

매개 변수 집합

NameAndPathParameterSet

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

NameAndLiteralPathParameterSet

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

-Name

저장할 모듈 이름의 배열을 지정합니다.

매개 변수 속성

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

매개 변수 집합

NameAndPathParameterSet

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

NameAndLiteralPathParameterSet

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

-Path

저장된 모듈을 저장할 로컬 컴퓨터의 위치를 지정합니다. 와일드카드 문자를 허용합니다.

매개 변수 속성

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

매개 변수 집합

NameAndPathParameterSet

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

InputObjectAndPathParameterSet

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

-Proxy

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

매개 변수 속성

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

매개 변수 집합

(All)

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

-ProxyCredential

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

매개 변수 속성

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

매개 변수 집합

(All)

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

-Repository

실행 Register-PSRepository하여 등록된 리포지토리의 이름을 지정합니다. Get-PSRepository 사용하여 등록된 리포지토리를 표시합니다.

매개 변수 속성

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

매개 변수 집합

NameAndPathParameterSet

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

NameAndLiteralPathParameterSet

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

-RequiredVersion

저장할 모듈의 정확한 버전 번호를 지정합니다.

매개 변수 속성

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

매개 변수 집합

NameAndPathParameterSet

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

NameAndLiteralPathParameterSet

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

-WhatIf

Save-Module 실행될 경우 어떤 일이 발생하는지 표시합니다. 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 블로그의 공지 참조하세요.