다음을 통해 공유

PowerShell 갤러리 시작

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

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

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

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

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

패키지를 선택한 후에는 그 패키지에 대해 더 알아보고 싶을 수도 있습니다. 갤러리의 패키지 페이지를 살펴보세요. 패키지 페이지에는 패키지와 함께 업로드된 메타데이터가 포함되어 있습니다. 메타데이터는 패키지 작성자가 제공합니다. 마이크로소프트는 이 정보를 검증하지 않습니다. 패키지의 소유자는 패키지를 게시하는 데 사용되는 갤러리 계정과 연관되어 있습니다. 소유자 계정이 저자 필드보다 더 권위 있는 경우입니다.

선의로 공개되지 않은 패키지를 발견하면, 해당 패키지 페이지에서 ' 남용 신고 '를 선택하세요.

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

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

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

검열하다

갤러리에서 패키지를 다운로드하여 검사하려면 패키지의 또는 Save-Script cmdlet을 사용 Save-Module 하세요. 이 명령어들은 패키지를 설치하지 않고 로컬에 저장합니다. 패키지 내용물을 점검하세요. 저장된 패키지를 수동으로 삭제해야 합니다.

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

선의로 공개되지 않은 패키지를 발견하면, 해당 패키지 페이지에서 ' 남용 신고 '를 선택하세요.

설치하다

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

기본적으로 Install-Module 모듈 $env:ProgramFiles\WindowsPowerShell\Modules 을 위치에 설치하는데, 이는 관리자 계정이 필요합니다. 매개변수를 -Scope CurrentUser 추가하면 명령어가 모듈을 $HOME\Documents\WindowsPowerShell\Modules 에 설치합니다.

기본적으로 Install-Script 스크립트를 위치(location)에 $env:ProgramFiles\WindowsPowerShell\Scripts 설치하는데, 관리자 계정이 필요합니다. 매개변수를 -Scope CurrentUser 추가하면 명령어가 스크립트를 $HOME\Documents\WindowsPowerShell\Scripts에 설치합니다.

Install-Module Install-Script 그리고 패키지의 최신 버전을 설치합니다. 이전 버전의 패키지를 설치하려면 -RequiredVersion 매개 변수를 추가합니다.

전개시키다

PowerShell 갤러리에서 Azure Automation으로 패키지를 배포하려면 Azure Automation을 선택한 후 패키지 세부 정보 페이지에서 Deploy to Azure Automation 을 선택하세요. Azure 계정 자격 증명으로 로그인하는 Azure 관리 포털로 리디렉션됩니다. 의존성이 있는 패키지를 배포하면 모든 의존성이 Azure Automation에 배포됩니다. Azure 로 배포 자동화 버튼을 패키지 메타데이터에 AzureAutomationNotSupported 태그를 추가하면 비활성화할 수 있습니다.

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

PowerShell 갤러리에서 설치된 패키지를 업데이트하려면 Update-Module 또는 Update-Script cmdlet을 실행합니다. 다른 매개변수 없이 실행될 때, Update-Module .Install-Module 모듈을 선택적으로 업데이트하려면 -Name 매개 변수를 추가합니다.

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

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

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

중요하다

PowerShell 갤러리에는 TLS(전송 계층 보안) 1.2 이상이 필요합니다. TLS 1.2 이상을 사용하지 않는 경우 PowerShell 갤러리에 액세스하려고 할 때 오류가 발생합니다. 다음 명령을 사용하여 TLS 1.2를 사용하고 있는지 확인합니다.

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

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

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

  • cdn.oneget.org
  • cdn.powershellgallery.com

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

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

메모

로 azureedge.net 끝나는 이전 엔드포인트는 더 이상 지원되지 않습니다.

  • Last updated on