about_Modules

아티클
03/18/2024

간단한 설명

PowerShell 모듈을 설치, 가져오기 및 사용하는 방법을 설명합니다.

자세한 설명

PowerShell은 스크립팅 언어 및 명령 셸입니다. 언어는 처리의 구조와 논리를 제공하는 키워드(keyword) 및 작업을 수행하는 명령으로 구성됩니다. PowerShell의 명령은 스크립트, 함수 또는 cmdlet으로 구현됩니다.

모듈은 cmdlet, 공급자, 함수, 변수 및 단일 단위로 가져올 수 있는 다른 유형의 리소스를 포함할 수 있는 자체 포함 재사용 가능한 단위입니다.

PowerShell에는 기본 모듈 세트가 함께 제공됩니다. 필요에 따라 더 많은 모듈을 설치할 수도 있습니다. 기본적으로 설치된 모듈은 모듈의 명령을 처음 사용할 때 자동으로 로드됩니다. 변수를 $PSModuleAutoloadingPreference 사용하여 모듈의 자동 로드를 활성화, 비활성화 및 구성합니다. 자세한 내용은 about_Preference_Variables 참조하세요.

세션 중에 언로드하거나 다시 로드할 수 있습니다. cmdlet을 Remove-Module 사용하여 세션에서 모듈을 언로드합니다. cmdlet을 Import-Module 사용하여 모듈을 로드합니다.

모듈은 C#으로 작성된 컴파일된 .NET 어셈블리 또는 PowerShell로 작성된 스크립트 기반 모듈로 만들 수 있습니다. 이 항목에서는 PowerShell 모듈을 사용하는 방법을 설명합니다. PowerShell 모듈을 작성하는 방법에 대한 자세한 내용은 PowerShell 모듈 작성을 참조하세요.

참고 항목

PowerShell 3.0 이전에는 cmdlet 및 공급자가 PowerShell 스냅인에 패키지되었습니다. PowerShell 3.0 부터 Microsoft.PowerShell.Core 스냅인은 기본적으로 모든 세션에 추가됩니다. PowerShell에서 유일한 스냅인 다시 기본. 다른 모든 스냅인은 모듈로 변환되었습니다. 새 스냅인 만들기는 더 이상 지원되지 않습니다.

게시된 모듈 설치

게시된 모듈은 등록된 리포지토리(예: PowerShell 갤러리)에서 사용할 수 있는 모듈입니다. PowerShellGet 및 Microsoft.PowerShell.PSResourceGet 모듈은 등록된 리포지토리에 PowerShell 모듈을 찾고 설치하고 게시하기 위한 cmdlet을 제공합니다.

PowerShellGet 모듈은 PowerShell 5.0 이상 릴리스에 포함되어 있습니다. Microsoft.PowerShell.PSResourceGet 모듈은 PowerShell 7.4 이상 릴리스에 포함되어 있습니다. Microsoft.PowerShell.PSResourceGet 은 PowerShell의 새로운 기본 패키지 관리자이며 이전 버전의 PowerShell에 설치할 수 있습니다. or Install-PSResource cmdlet을 Install-Module 사용하여 PowerShell 갤러리 모듈을 설치합니다.

 Get-Command Install-Module, Install-PSResource

CommandType  Name                Version    Source
-----------  ----                -------    ------
Function     Install-Module      2.9.0      PowerShellGet
Cmdlet       Install-PSResource  1.0.0      Microsoft.PowerShell.PSResourceGet

자세한 내용은 PowerShellGet 개요를 참조 하세요.

모듈 수동 설치

모듈을 파일이 있는 폴더로 수신하는 경우 PowerShell에서 사용하기 전에 컴퓨터에 모듈을 설치해야 합니다.

PowerShell에는 미리 설치된 여러 모듈이 함께 제공됩니다. Windows 기반 컴퓨터에서 많은 Windows 기능에는 기능 관리를 위한 모듈이 포함됩니다. 이러한 모듈은 기능이 설치될 때 설치됩니다. 다른 모듈은 모듈을 설치하는 설치 관리자 또는 설치 프로그램에 포함될 수 있습니다.

기본적으로 Modules 현재 사용자의 폴더가 없습니다. 모듈 CurrentUser 을 사용 Install-Module 하거나 Install-PSResource범위에 설치한 경우 해당 cmdlet은 현재 사용자의 폴더를 만듭니 Modules 다. 폴더가 없으면 수동으로 만들 수 있습니다.

다음 명령을 사용하여 현재 사용자에 대한 폴더를 만듭니 Modules 다.

$folder = New-Item -Type Directory -Path $HOME\Documents\PowerShell\Modules

전체 모듈 폴더를 새로 만든 폴더에 복사합니다. PowerShell에서 cmdlet을 Copy-Item 사용합니다. 예를 들어 다음 명령을 실행하여 방금 만든 폴더로 C:\PSTest 폴더를 복사 MyModule 합니다.

Copy-Item -Path C:\PSTest\MyModule -Destination $folder

모든 위치에 모듈을 설치할 수 있지만 기본 모듈 위치에 모듈을 설치하면 쉽게 관리할 수 있습니다. 기본 모듈 위치에 대한 자세한 내용은 about_PSModulePath 참조하세요.

모듈 자동 로드

설치된 모듈에서 명령을 처음 실행할 때 PowerShell은 해당 모듈을 자동으로 가져오고 로드합니다. 모듈은 환경 변수에 지정된 $env:PSModulePath 위치에 저장해야 합니다. 다른 위치의 모듈은 cmdlet을 Import-Module 사용하여 가져와야 합니다.

모듈 자동 로드를 사용하면 설정 또는 프로필 구성 없이 모듈에서 명령을 사용할 수 있습니다. 모듈을 컴퓨터에 설치한 후에는 모듈을 관리할 필요가 없습니다.

다음 각 예제에서는 포함된 Get-CimInstanceCimCmdlets 모듈을 세션으로 가져옵니다.

명령 실행
```
Get-CimInstance Win32_OperatingSystem
```
명령 가져오기
```
Get-Command Get-CimInstance
```
명령에 대한 도움말 보기
```
Get-Help Get-CimInstance
```

cmdlet은 아직 세션에 없는 경우에도 설치된 모든 모듈의 명령 목록을 사용할 Get-Command 수 있습니다. 와일드 카드 문자(*)와 함께 사용하는 Get-Command 경우 PowerShell은 모듈을 가져오지 않습니다. 세션에서 필요하지 않을 수 있는 모듈을 로드하지 않고도 명령 검색에 wild카드s를 사용할 수 있습니다.

또한 PowerShell 공급자를 사용하는 명령은 모듈을 자동으로 가져오지 않습니다. 예를 들어 cmdlet과 같이 Get-PSSessionConfiguration 드라이브가 필요한 WSMan: 명령을 사용하는 경우 cmdlet을 실행 Import-Module 하여 드라이브를 포함하는 WSMan: Microsoft.WSMan.Management 모듈을 가져와야 할 수 있습니다.

모듈 수동 가져오기

모듈을 환경 변수에 지정된 위치에 설치하지 않거나 모듈이 패키지된 $env:PSModulePath 모듈이 아닌 독립 실행형 .dll 또는 .psm1 파일로 제공되는 경우 모듈을 수동으로 가져와야 합니다.

세션에서 모듈을 가져오는 방법을 변경할 수도 있습니다. 예를 들어 접두사 매개 변수는 Import-Module 모듈에서 가져온 cmdlet의 명사 부분에 고유한 접두사를 추가합니다. NoClobber 매개 변수를 사용하면 모듈이 세션의 기존 명령을 숨기거나 바꿀 명령을 추가할 수 없습니다. 자세한 내용은 이름 충돌 관리를 참조 하세요.

모듈 이름을 지정하여 설치된 모듈을 가져올 수 있습니다 $env:PSModulePath . 예를 들어 다음 명령은 BitsTransfer 모듈을 현재 세션으로 가져옵니다.

Import-Module BitsTransfer

모듈에 $env:PSModulePath없는 모듈을 가져오려면 모듈 폴더에 대한 정규화된 경로를 사용합니다. 예를 들어 디렉터리의 TestCmdlet 모듈을 세션에 C:\ps-test 추가하려면 다음을 입력합니다.

Import-Module C:\ps-test\TestCmdlets

모듈 폴더에 포함되지 않은 모듈 파일을 가져오려면 명령에서 모듈 파일에 대한 정규화된 경로를 사용합니다. 예를 들어 디렉터리의 TestCmdlets.dll 모듈을 세션에 C:\ps-test 추가하려면 다음을 입력합니다.

Import-Module C:\ps-test\TestCmdlets.dll

세션에 모듈을 추가하는 방법에 대한 자세한 내용은 Import-Module을 참조하세요.

모든 세션이 시작될 때 모듈 가져오기

이 Import-Module 명령은 모듈을 현재 PowerShell 세션으로 가져옵니다. 시작하는 모든 PowerShell 세션으로 모듈을 가져오려면 PowerShell 프로필에 Import-Module 명령을 추가합니다.

프로필에 대한 자세한 내용은 about_Profiles 참조하세요.

설치된 모듈 찾기

cmdlet은 Get-Module 세션에서 가져온 PowerShell 모듈을 가져옵니다.

Get-Module

나열된 모듈에는 .에서뿐만 $env:PSModulePath아니라 모든 위치에서 가져온 모듈이 포함될 수 있습니다.

다음 명령을 사용하여 다음에 설치된 $env:PSModulePath모듈을 나열합니다.

Get-Module -ListAvailable

이 명령은 현재 세션으로 가져온 모듈뿐만 아니라 설치된 $env:PSModulePath모든 모듈을 가져옵니다. 이 명령은 다른 위치에 설치된 모듈을 나열하지 않습니다.

자세한 내용은 Get-Module을 참조 하세요.

모듈의 명령 나열

cmdlet을 Get-Command 사용하여 사용 가능한 모든 명령을 찾습니다. cmdlet의 매개 변수를 Get-Command 사용하여 모듈, 이름 및 명사별로 명령을 필터링할 수 있습니다.

모듈에서 모든 명령을 찾으려면 다음을 입력합니다.

Get-Command -Module <module-name>

예를 들어 BitsTransfer 모듈에서 명령을 찾으려면 다음을 입력합니다.

Get-Command -Module BitsTransfer

cmdlet에 Get-Command 대한 자세한 내용은 Get-Command를 참조하세요.

모듈 제거

모듈을 제거하면 모듈이 추가한 명령이 세션에서 삭제됩니다. 예를 들어 다음 명령은 현재 세션에서 BitsTransfer 모듈을 제거합니다.

Remove-Module BitsTransfer

모듈을 제거하면 모듈 가져오기 작업이 취소됩니다. 모듈을 제거해도 모듈은 제거되지 않습니다. 자세한 내용은 Remove-Module을 참조 하세요.

모듈 및 스냅인에서 세션에 명령을 추가할 수 있습니다. 모듈은 cmdlet, 공급자 및 함수를 비롯한 모든 유형의 명령과 변수, 별칭 및 PowerShell 드라이브와 같은 항목을 추가할 수 있습니다. 스냅인에서는 cmdlet과 공급자만 추가할 수 있습니다.

세션에서 모듈을 제거하기 전에 다음 명령을 사용하여 제거할 모듈을 결정합니다.

예를 들어 다음 명령을 사용하여 및 Get-Help cmdlet의 원본을 Get-Date 찾습니다.

Get-Command Get-Date, Get-Help -All |
    Select-Object -Property Name, CommandType, Module ,PSSnapIn

다음 출력은 cmdlet이 Microsoft.PowerShell.Core 스냅인에 있음을 Get-Help 보여줍니다. 이 스냅인은 세션에서 제거할 수 없습니다.

Name     CommandType Module                       PSSnapIn
----     ----------- ------                       --------
Get-Date    Function
Get-Date      Cmdlet Microsoft.PowerShell.Utility
Get-Help      Cmdlet                              Microsoft.PowerShell.Core

에 대한 Get-Date두 가지 소스가 있습니다. 하나는 함수이고 다른 하나는 Microsoft.PowerShell.Utility 모듈의 cmdlet입니다. 를 사용하여 Remove-Module모듈을 제거할 수 있습니다. 함수를 제거하려면 드라이브에서 해당 함수를 삭제할 Function: 수 있습니다.

Remove-Item Function:Get-Date

드라이브에 대한 Function: 자세한 내용은 about_Function_Provider 참조하세요.

이름 충돌 관리

세션에서 둘 이상의 명령 이름이 같은 경우 이름 충돌이 발생합니다. 모듈을 가져오면 모듈의 명령 이름이 세션의 명령 또는 항목과 같을 때 이름이 충돌합니다.

Import-Module 는 현재 세션에서 명령을 숨기고 바꾸는 명령을 추가할 수 있습니다. 이름 충돌이 발생하면 명령이 숨겨지거나 바뀝니다. 가져온 모듈에 세션의 기존 명령과 이름이 같은 명령이 포함된 경우 명령 대체가 발생합니다. 새로 가져온 명령 바꾸기가 기존 명령보다 우선합니다.

예를 들어 세션에 동일한 이름의 함수와 cmdlet이 포함된 경우 PowerShell은 기본적으로 함수를 실행합니다. 세션에 동일한 이름을 가진 동일한 형식의 명령(예: 이름이 같은 두 cmdlet)이 포함된 경우 기본적으로 가장 최근에 추가된 명령을 실행합니다.

선행 규칙에 대한 설명과 숨겨진 명령 실행에 대한 지침을 비롯한 자세한 내용은 about_Command_Precedence 참조하세요.

명령 이름을 한정하여 숨기거나 대체한 명령을 실행할 수 있습니다. 명령 이름을 한정하려면 원하는 명령 버전보다 모듈의 이름을 추가합니다. 예시:

Microsoft.PowerShell.Utility\Get-Date

모듈 이름 접두사를 사용하여 실행 Get-Date 하면 Microsoft.PowerShell.Utility 모듈에서 버전을 실행합니다.

이름 충돌을 감지하려면 cmdlet의 All 매개 변수를 Get-Command 사용합니다. 기본적으로 Get-Command 명령 이름을 입력할 때 실행되는 명령만 가져옵니다. All 매개 변수는 세션의 특정 이름을 가진 모든 명령을 가져옵니다.

이름 충돌을 방지하려면 cmdlet의 NoClobber 또는 접두사 매개 변수를 Import-Module 사용합니다. 접두사 매개 변수는 가져온 명령의 이름에 접두사를 추가하여 세션에서 고유하도록 합니다. NoClobber 매개 변수는 세션의 기존 명령을 숨기거나 바꾸는 명령을 가져오지 않습니다.

또한 별칭, Cmdlet, 함수 및 변수 매개 변수 Import-Module 를 사용하여 가져오려는 명령만 선택할 수 있으며 세션에서 이름 충돌을 일으키는 명령을 제외할 수 있습니다.

모듈 작성자는 모듈 매니페스트의 DefaultCommandPrefix 속성을 사용하여 모든 명령 이름에 기본 접두사를 추가하여 이름 충돌을 방지할 수 있습니다. 접두사 매개 변수의 값이 DefaultCommandPrefix 값보다 우선합니다.