다음을 통해 공유

Update-Module

  • 참조
모듈:
PowerShellGet

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

Syntax

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 합니다.

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

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

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

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

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

예제

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

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

Update-Module

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

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

Update-Module -Name SpeculationControl

Update-Module 에서는 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

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

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

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

Update-Module -Name SpeculationControl -Force

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

매개 변수

-AcceptLicense

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowPrerelease

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

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

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RequiredVersion

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Scope

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

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

$env:ProgramFiles\PowerShell\Modules

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

$HOME\Documents\PowerShell\Modules

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

  • PowerShellGet 버전 2.0.0 이상에서 기본값은 CurrentUser이며 설치를 위해 권한 상승이 필요하지 않습니다.
  • PowerShellGet 1.x 버전에서 기본값은 AllUsers이며 설치를 위해 상승이 필요합니다.
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:CurrentUser
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

String[]

String

PSCredential

Uri

출력

Object

참고

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

  • 모든 플랫폼:
    • upmo

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

중요

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

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

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

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

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

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

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