다음을 통해 공유

PowerShell 갤러리 시작

  • 아티클

PowerShell 갤러리는 다운로드하고 활용할 수 있는 스크립트, 모듈 및 DSC 리소스를 포함하는 패키지 리포지토리입니다. PowerShellGet 모듈의 cmdlet을 사용하여 PowerShell 갤러리에서 패키지를 설치합니다. PowerShell 갤러리에서 항목을 다운로드하기 위해 로그인할 필요가 없습니다.

메모

PowerShell 갤러리에서 직접 패키지를 다운로드할 수 있지만 권장되는 방법은 아닙니다. 자세한 내용은 수동 패키지 다운로드참조하세요.

PowerShell 갤러리의 홈페이지Search 컨트롤을 사용하거나 패키지 페이지모듈 및 스크립트를 검색하여 PowerShell 갤러리에서 패키지를 찾을 수 있습니다. -Repository PSGallery사용하여 패키지 유형에 따라 Find-Module, Find-DscResource및 Find-Script cmdlet을 실행하여 PowerShell 갤러리에서 패키지를 찾을 수도 있습니다.

다음 매개 변수를 사용하여 갤러리의 결과를 필터링할 수 있습니다.

  • 이름
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • 태그
  • 포함
  • DscResource
  • RoleCapability
  • 명령
  • 필터

갤러리에서 특정 DSC 리소스를 검색하는 데만 관심이 있는 경우 Find-DscResource cmdlet을 실행할 수 있습니다. Find-DscResource 갤러리에 포함된 DSC 리소스에 대한 데이터를 반환합니다. DSC 리소스는 항상 모듈의 일부로 제공되므로 Install-Module 실행하여 해당 DSC 리소스를 설치해야 합니다.

관심 있는 패키지를 확인한 후에는 해당 패키지에 대해 자세히 알아볼 수 있습니다. 갤러리에서 해당 패키지의 특정 페이지를 검사하여 이 작업을 수행할 수 있습니다. 해당 페이지에서 패키지와 함께 업로드된 모든 메타데이터를 볼 수 있습니다. 이 메타데이터는 패키지 작성자가 제공하며 Microsoft에서 확인하지 않습니다. 패키지의 소유자는 패키지를 게시하는 데 사용되는 갤러리 계정에 강력하게 연결되어 있으며 작성자 필드보다 더 신뢰할 수 있습니다.

선의로 게시되지 않은 것으로 생각되는 패키지를 발견하면 해당 패키지의 페이지에서 보고서 남용 클릭합니다.

Find-Module 또는 Find-Script실행하는 경우 반환된 PSGetModuleInfo 개체에서 이 데이터를 볼 수 있습니다. 다음 예제에서는 갤러리의 PSReadLine 모듈의 데이터를 반환합니다.

Find-Module -Name PSReadLine -Repository PSGallery | Get-Member

PowerShell 갤러리에서 패키지를 다운로드할 때 다음 프로세스를 사용하는 것이 좋습니다.

검열하다

검사를 위해 갤러리에서 패키지를 다운로드하려면 패키지 유형에 따라 Save-Module 또는 Save-Script cmdlet을 실행합니다. 이렇게 하면 패키지를 설치하지 않고 로컬로 저장하고 패키지 콘텐츠를 검사할 수 있습니다. 저장된 패키지를 수동으로 삭제해야 합니다.

이러한 패키지 중 일부는 Microsoft에서 작성하며 다른 패키지는 PowerShell 커뮤니티에서 작성합니다. 설치하기 전에 이 갤러리에서 패키지의 내용과 코드를 검토하는 것이 좋습니다.

선의로 게시되지 않은 것으로 생각되는 패키지를 발견하면 해당 패키지의 페이지에서 보고서 남용 클릭합니다.

설치하다

갤러리에서 사용할 패키지를 설치하려면 패키지 유형에 따라 Install-Module 또는 Install-Script cmdlet을 실행합니다.

Install-Module 기본적으로 $env:ProgramFiles\WindowsPowerShell\Modules 모듈을 설치합니다. 이렇게 하려면 관리자 계정이 필요합니다. -Scope CurrentUser 매개 변수를 추가하면 $HOME\Documents\WindowsPowerShell\Modules 모듈이 설치됩니다.

Install-Script 기본적으로 $env:ProgramFiles\WindowsPowerShell\Scripts 스크립트를 설치합니다. 이렇게 하려면 관리자 계정이 필요합니다. -Scope CurrentUser 매개 변수를 추가하면 $HOME\Documents\WindowsPowerShell\Scripts 위해 스크립트가 설치됩니다.

기본적으로 Install-Module 및 Install-Script 패키지의 최신 버전을 설치합니다. 이전 버전의 패키지를 설치하려면 -RequiredVersion 매개 변수를 추가합니다.

전개시키다

PowerShell 갤러리에서 Azure Automation으로 패키지를 배포하려면 Azure Automation클릭한 다음 패키지 세부 정보 페이지에서 Azure Automation 배포를 클릭합니다. Azure 계정 자격 증명을 사용하여 로그인하는 Azure 관리 포털로 리디렉션됩니다. 종속성이 있는 패키지를 배포하면 모든 종속성이 Azure Automation에 배포됩니다. 패키지 메타데이터에 AzureAutomationNotSupported 태그를 추가하여 'Azure Automation에 배포' 단추를 사용하지 않도록 설정할 수 있습니다.

Azure Automation에 대한 자세한 내용은 Azure Automation 설명서를 참조하세요.

PowerShell 갤러리에서 설치된 패키지를 업데이트하려면 Update-Module 또는 Update-Script cmdlet을 실행합니다. 추가 매개 변수 없이 실행하는 경우 Update-ModuleInstall-Module실행하여 설치된 모든 모듈을 업데이트하려고 시도합니다. 모듈을 선택적으로 업데이트하려면 -Name 매개 변수를 추가합니다.

마찬가지로, 추가 매개 변수 없이 실행하는 경우 Update-ScriptInstall-Script실행하여 설치된 모든 스크립트를 업데이트하려고 시도합니다. 스크립트를 선택적으로 업데이트하려면 -Name 매개 변수를 추가합니다.

PowerShell 갤러리에서 설치한 모듈을 확인하려면 Get-InstalledModule cmdlet을 실행합니다. 이 명령은 PowerShell 갤러리에서 직접 설치된 시스템에 있는 모든 모듈을 나열합니다.

마찬가지로 PowerShell 갤러리에서 설치한 스크립트를 확인하려면 Get-InstalledScript cmdlet을 실행합니다. 이 명령은 PowerShell 갤러리에서 직접 설치된 시스템에 있는 모든 스크립트를 나열합니다.

이러한 호스트 이름은 네트워크에서 액세스를 제어하는 허용 목록에 추가되어야 합니다.

패키지 검색 및 다운로드에 필요한 호스트:

  • onegetcdn.azureedge.net
  • powershellgallery.azureedge.net
  • psg-prod-eastus.azureedge.net

PowerShell 갤러리 웹 사이트를 사용할 때 필요한 호스트:

  • *.powershellgallery.com - 웹 사이트
  • go.microsoft.com 및 aka.ms - 리디렉션 서비스

중요하다

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

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

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