다음을 통해 공유

Update-Module

  • 참조
모듈:
PowershellGet

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

구문

Update-Module
      [[-Name] <String[]>]
      [-RequiredVersion <Version>]
      [-MaximumVersion <Version>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

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

매개 변수가 지정되지 않은 Update-Module 설치된 모든 모듈을 업데이트합니다. 업데이트할 모듈을 지정하려면 Name 매개 변수를 사용합니다. RequiredVersion 매개 변수를 사용하여 모듈의 특정 버전으로 업데이트할 수 있습니다.

설치된 모듈이 이미 최신 버전인 경우 모듈은 업데이트되지 않습니다. $env:PSModulePath모듈을 찾을 수 없으면 오류가 표시됩니다.

설치된 모듈을 표시하려면 Get-InstalledModule사용합니다.

예제

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

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

Update-Module

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

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

Update-Module -Name SpeculationControl

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

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

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

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

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

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

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

Update-Module -Name SpeculationControl -Force

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

매개 변수

-Confirm

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

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

-Force

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

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

-MaximumVersion

업데이트할 단일 모듈의 최대 버전을 지정합니다. 여러 모듈을 업데이트하려는 경우 이 매개 변수를 추가할 수 없습니다. MaximumVersion 및 RequiredVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.

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

-Name

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

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

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

-RequiredVersion

기존에 설치된 모듈을 업데이트할 정확한 버전을 지정합니다. RequiredVersion 지정한 버전이 온라인 갤러리에 있어야 합니다. 그렇지 않은 경우 오류가 표시됩니다. 단일 명령에서 둘 이상의 모듈이 업데이트되는 경우 RequiredVersion사용할 수 없습니다.

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

-WhatIf

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

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

참고

PowerShell 5.1 이하의 경우 상승된 세션의 기본 범위는 AllUsers, 상승되지 않은 세션에서는 CurrentUser. AllUsers, $env:ProgramFiles\PowerShell\Modules모듈 업데이트에는 상승된 권한이 필요합니다. $home\Documents\PowerShell\Modules CurrentUser대한 모듈 업데이트에는 상승된 권한이 필요하지 않습니다.

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

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

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

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