Update-Module

참조

모듈:: PowerShellGet

온라인 갤러리에서 로컬 컴퓨터로 지정된 모듈의 최신 버전을 다운로드하여 설치합니다.

구문

Update-Module
      [[-Name] <String[]>]
      [-RequiredVersion <String>]
      [-MaximumVersion <String>]
      [-Credential <PSCredential>]
      [-Scope <String>]
      [-Proxy <Uri>]
      [-ProxyCredential <PSCredential>]
      [-Force]
      [-AllowPrerelease]
      [-AcceptLicense]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

cmdlet은 Update-Module 온라인 갤러리에서 모듈의 최신 버전을 설치합니다. 업데이트가 설치되기 전에 확인하라는 메시지가 표시됩니다. 업데이트는 로컬 컴퓨터에 Install-Module설치된 모듈에 대해서만 설치됩니다. Update-Module 는 설치된 모듈을 검색 $env:PSModulePath 합니다.

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

예제

예제 1: 모든 모듈 업데이트

다음은 설치된 모든 모듈을 온라인 갤러리의 최신 버전으로 업데이트하는 예제입니다.

Update-Module

예제 2: 이름으로 모듈 업데이트

다음은 특정 모듈을 온라인 갤러리의 최신 버전으로 업데이트하는 예제입니다.

Update-Module -Name SpeculationControl

Update-Module 는 Name 매개 변수를 사용하여 특정 모듈인 SpeculationControl을 업데이트합니다.

예제 3: what-if Update-Module 실행 보기

이 예제에서는 실행되면 어떻게 되는지 보여 주도록 what-if Update-Module 시나리오를 수행합니다. 명령이 실행되지 않습니다.

Update-Module -WhatIf

What if: Performing the operation "Update-Module" on target "Version '2.8.0' of module
  'Carbon', updating to version '2.8.1'".
What if: Performing the operation "Update-Module" on target "Version '1.0.10' of module
  'SpeculationControl', updating to version '1.0.14'".

Update-Module 는 WhatIf 매개 변수를 사용하여 실행될 경우 Update-Module 어떤 일이 발생하는지 표시합니다.

예제 4: 모듈을 지정된 버전으로 업데이트

이 예제에서는 모듈이 특정 버전으로 업데이트됩니다. 버전은 온라인 갤러리에 있어야 합니다. 그렇지 않은 경우 오류가 표시됩니다.

Update-Module -Name SpeculationControl -RequiredVersion 1.0.14

Update-Module 는 Name 매개 변수를 사용하여 모듈인 SpeculationControl을 지정합니다. RequiredVersion 매개 변수는 버전 1.0.14를 지정합니다.

예제 5: 확인 없이 모듈 업데이트

이 예제에서는 온라인 갤러리에서 모듈을 최신 버전으로 업데이트하는 확인을 요청하지 않습니다. 모듈이 이미 설치된 경우 Force 매개 변수는 모듈을 다시 설치합니다.

Update-Module -Name SpeculationControl -Force

Update-Module 는 Name 매개 변수를 사용하여 모듈인 SpeculationControl을 지정합니다. Force 매개 변수는 사용자 확인을 요청하지 않고 모듈을 업데이트합니다.

매개 변수

-AcceptLicense

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

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

-AllowPrerelease

시험판으로 표시된 최신 모듈을 사용하여 모듈을 업데이트할 수 있습니다.

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

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

-Confirm

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

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

-Credential

모듈을 업데이트할 수 있는 권한이 있는 사용자 계정을 지정합니다.

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

-Force

확인을 요청하라는 프롬프트 없이 지정된 각 모듈의 업데이트를 강제로 적용합니다. 모듈이 이미 설치된 경우 강제로 모듈을 다시 설치합니다.

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

-MaximumVersion

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

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

-Name

업데이트할 하나 이상의 모듈 이름을 지정합니다. Update-Module 는 업데이트할 모듈을 검색 $env:PSModulePath 합니다. 지정한 모듈 이름에 $env:PSModulePath 일치하는 항목이 없으면 오류가 발생합니다.

와일드카드는 모듈 이름에 허용됩니다. 지정된 이름에 와일드카드 문자를 추가하고 일치하는 항목을 찾을 수 없으면 오류가 발생하지 않습니다.

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

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

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

-Proxy

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

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

-ProxyCredential

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

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

-RequiredVersion

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

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

-Scope

모듈의 설치 범위를 지정합니다. 이 매개 변수에 허용되는 값은 AllUsers 및 CurrentUser입니다. 범위를 지정하지 않으면 업데이트가 CurrentUser 범위에 설치됩니다.

AllUsers 범위에는 상승된 권한이 필요하며 컴퓨터의 모든 사용자가 액세스할 수 있는 위치에 모듈을 설치합니다.

$env:ProgramFiles\PowerShell\Modules

CurrentUser는 상승된 권한이 필요하지 않으며 컴퓨터의 현재 사용자만 액세스할 수 있는 위치에 모듈을 설치합니다.

$HOME\Documents\PowerShell\Modules

범위가 정의되지 않은 경우 기본값은 PowerShellGet 버전에 따라 설정됩니다.

PowerShellGet 버전 2.0.0 이상에서 기본값은 설치에 대한 권한 상승이 필요하지 않은 CurrentUser입니다.
PowerShellGet 1.x 버전에서 기본값은 설치에 대한 권한 상승이 필요한 AllUsers입니다.

형식:	String
허용되는 값:	CurrentUser, AllUsers
Position:	Named
Default value:	CurrentUser
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

Update-Module 실행될 경우 어떤 일이 발생하는지 보여줍니다. cmdlet이 실행되지 않습니다.

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

입력

String[]

String

PSCredential

Uri

출력

Object

참고

PowerShell에는 Update-Module에 대한 다음과 같은 별칭들이 포함되어 있습니다.

모든 플랫폼:
- upmo

PowerShell 버전 6.0 이상의 경우 기본 설치 범위는 항상 CurrentUser입니다. CurrentUser에 대한 모듈 업데이트는 $HOME\Documents\PowerShell\Modules상승된 권한이 필요하지 않습니다. AllUsers에 대한 모듈 업데이트는 $env:ProgramFiles\PowerShell\Modules상승된 권한이 필요합니다.

PowerShell 갤러리는 더 이상 TLS(전송 계층 보안) 버전 1.0 및 1.1을 지원하지 않습니다. TLS 1.2 이상을 사용해야 합니다. 다음 명령을 사용하여 TLS 1.2를 사용하고 있는지 확인합니다.

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

Update-Module 는 PowerShell의 PowerShell 3.0 이상 릴리스, Windows 7 또는 Windows 2008 R2 이상 릴리스에서 실행됩니다.

Name 매개 변수를 사용하여 Install-Module지정한 모듈이 설치되지 않은 경우 오류가 발생합니다.

온라인 갤러리에서 설치한 모듈에서만 실행할 Update-Module 수 있습니다 Install-Module.

사용 Update-Module 중인 이진 파일을 업데이트하려고 하면 Update-Module 문제 프로세스를 식별하는 오류가 반환됩니다. 사용자에게 프로세스가 중지된 후 다시 시도 Update-Module 하라는 정보가 표시됩니다.