다음을 통해 공유


Update-Module

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

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

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

예제

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

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

Update-Module

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

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

Update-Module -Name SpeculationControl

Update-ModuleName 매개 변수를 사용하여 특정 모듈인 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-ModuleWhatIf 매개 변수를 사용하여 실행된 경우 Update-Module 어떤 일이 발생할지 표시합니다.

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

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

Update-Module -Name SpeculationControl -RequiredVersion 1.0.14

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

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

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

Update-Module -Name SpeculationControl -Force

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

매개 변수

-AcceptLicense

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

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

-AllowPrerelease

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

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

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

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

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

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

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

-ProxyCredential

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

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

-RequiredVersion

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

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

-Scope

모듈의 설치 범위를 지정합니다. 이 매개 변수에 허용되는 값은 AllUsersCurrentUser입니다. 범위를 지정하지 않으면 업데이트가 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에 대한 모듈 업데이트에는 상승된 권한이 필요합니다.

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

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

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

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

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

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