PowerShell 갤러리 시작Getting Started with the PowerShell Gallery

PowerShell 갤러리에서 패키지를 설치하는 올바른 방법은 PowerShellGet 모듈에서 cmdlet을 사용하는 것입니다.The proper way to install packages from the PowerShell Gallery is to use the cmdlets in the PowerShellGet module. PowerShell 갤러리에서 항목을 다운로드하기 위해 로그인할 필요는 없습니다.You do not need to sign in to download items from the PowerShell Gallery.

참고

패키지는 PowerShell 갤러리에서 직접 다운로드할 수 있지만 권장되는 방법이 아닙니다.It is possible to download a package from the PowerShell Gallery directly, but this is not a recommended approach. 자세한 내용은 수동 패키지 다운로드를 참조하세요.For more details, see Manual Package Download.

이 웹 사이트에서 검색 컨트롤을 사용하거나 모듈 및 스크립트 페이지를 검색하여 PowerShell 갤러리에서 패키지를 찾을 수 있습니다.You can find packages in the PowerShell Gallery by using the Search control on this website, or by browsing through the Modules and Scripts pages. 항목 유형에 따라 Find-ModuleFind-Script cmdlet을 -Repository PSGallery와 함께 사용하여 PowerShell 갤러리에서 패키지를 찾을 수도 있습니다.You can also find packages from the PowerShell Gallery by running the Find-Module and Find-Script cmdlets, depending on the item type, with -Repository PSGallery.

다음 매개 변수를 사용하여 갤러리의 결과를 필터링할 수 있습니다.Filtering results from the Gallery can be done by using the following parameters:

  • 이름Name
  • AllVersionsAllVersions
  • MinimumVersionMinimumVersion
  • RequiredVersionRequiredVersion
  • 태그Tag
  • IncludesIncludes
  • DscResourceDscResource
  • RoleCapabilityRoleCapability
  • 명령Command
  • 필터Filter

갤러리에서 특정 DSC 리소스를 검색하는 데만 관심이 있는 경우 Find-DscResource cmdlet을 실행할 수 있습니다.If you're only interested in discovering specific DSC resources in the Gallery, you can run the Find-DscResource cmdlet. Find-DscResource는 갤러리에 포함된 DSC 리소스에 대한 데이터를 반환합니다.Find-DscResource returns data on DSC resources contained in the Gallery. DSC 리소스는 항상 모듈의 일부로 제공되기 때문에 여전히 Install-Module을 실행하여 이러한 DSC 리소스를 설치해야 합니다.Because DSC resources are always delivered as part of a module, you still need to run Install-Module to install those DSC resources.

관심 있는 패키지를 찾았으면 자세히 알아보는 것이 좋습니다.Once you've identified a package that you're interested in, you may want to learn more about it. 이렇게 하려면 갤러리에서 해당 패키지의 페이지를 살펴봅니다.You can do this by examining that package's specific page on the Gallery. 이 페이지에서 패키지와 함께 업로드된 메타데이터를 모두 볼 수 있습니다.On that page, you'll be able to see all of the metadata uploaded with the package. 이 메타데이터는 패키지의 작성자가 제공하며 Microsoft에서 확인하지 않습니다.This metadata is provided by the package's author, and is not verified by Microsoft. 패키지의 소유자는 패키지를 게시하는 데 사용되는 갤러리 계정에 강하게 연결되어 있으며 작성자 필드보다 더 신뢰할 수 있습니다.The Owner of the package is strongly tied to the Gallery account used to publish the package, and is more trustworthy than the Author field.

좋은 의도로 게시되지 않은 것 같은 패키지를 발견할 경우 해당 패키지의 페이지에서 신고하기를 클릭합니다.If you discover a package that you feel is not published in good faith, click Report Abuse on that package's page.

Find-Module 또는 Find-Script를 실행하는 경우 반환된 PSGetModuleInfo 개체에서 이 데이터를 볼 수 있습니다.If you're running Find-Module or Find-Script, you can view this data in the returned PSGetModuleInfo object. 예를 들어 Find-Module -Name PSReadLine -Repository PSGallery |Get-Member를 실행하면For example, running Find-Module -Name PSReadLine -Repository PSGallery |Get-Member 갤러리에서 PSReadLine 모듈의 데이터가 반환됩니다.returns data on the PSReadLine module in the Gallery.

PowerShell 갤러리에서 패키지를 다운로드하려면 다음 프로세스를 사용하는 것이 좋습니다.We encourage the following process when downloading packages from the PowerShell Gallery:

검사Inspect

검사를 위해 갤러리에서 패키지를 다운로드하려면 패키지 유형에 따라 Save-Module 또는 Save-Script cmdlet을 실행합니다.To download a package from the Gallery for inspection, run either the Save-Module or Save-Script cmdlet, depending on the package type. 이렇게 하면 설치하지 않고 로컬에 패키지를 저장한 다음 패키지 내용을 검사할 수 있습니다.This lets you save the package locally without installing it, and inspect the package contents. 저장된 패키지는 수동으로 삭제해야 합니다.Remember to delete the saved package manually.

이러한 패키지 중 일부는 Microsoft에서 작성되었으며 다른 항목은 PowerShell 커뮤니티에서 작성되었습니다.Some of these packages are authored by Microsoft, and others are authored by the PowerShell community. 설치 전에 이 갤러리에 있는 패키지의 내용과 코드를 검토하는 것이 좋습니다.Microsoft recommends that you review the contents and code of packages on this gallery prior to installation.

좋은 의도로 게시되지 않은 것 같은 패키지를 발견할 경우 해당 패키지의 페이지에서 신고하기를 클릭합니다.If you discover a package that you feel is not published in good faith, click Report Abuse on that package's page.

설치Install

사용을 위해 갤러리에서 패키지를 설치하려면 패키지 유형에 따라 Install-Module 또는 Install-Script cmdlet을 실행합니다.To install a package from the Gallery for use, run either the Install-Module or Install-Script cmdlet, depending on the package type.

Install-Module은 기본적으로 $env:ProgramFiles\WindowsPowerShell\Modules에 모듈을 설치합니다.Install-Module installs the module to $env:ProgramFiles\WindowsPowerShell\Modules by default. 이 경우 관리자 계정이 필요합니다.This requires an administrator account. -Scope CurrentUser 매개 변수를 추가하는 경우 모듈은 $env:USERPROFILE\Documents\WindowsPowerShell\Modules에 설치됩니다.If you add the -Scope CurrentUser parameter, the module is installed to $env:USERPROFILE\Documents\WindowsPowerShell\Modules .

Install-Script는 기본적으로 $env:ProgramFiles\WindowsPowerShell\Scripts에 스크립트를 설치합니다.Install-Script installs the script to $env:ProgramFiles\WindowsPowerShell\Scripts by default. 이 경우 관리자 계정이 필요합니다.This requires an administrator account. -Scope CurrentUser 매개 변수를 추가하는 경우 스크립트는 $env:USERPROFILE\Documents\WindowsPowerShell\Scripts에 설치됩니다.If you add the -Scope CurrentUser parameter, the script is installed to $env:USERPROFILE\Documents\WindowsPowerShell\Scripts .

기본적으로 Install-ModuleInstall-Script는 최신 버전의 패키지를 설치합니다.By default, Install-Module and Install-Script installs the most current version of a package. 이전 버전의 패키지를 설치하려면 -RequiredVersion 매개 변수를 추가합니다.To install an older version of the package, add the -RequiredVersion parameter.

배포 게스트 클러스터에Deploy

PowerShell 갤러리의 패키지를 Azure Automation에 배포하려면 패키지 세부 정보 페이지에서 Azure Automation에 배포를 클릭합니다.To deploy a package from the PowerShell Gallery to Azure Automation, click Deploy to Azure Automation on the package details page. Azure 관리 포털로 리디렉션되며, 여기서 Azure 계정 자격 증명을 사용하여 로그인합니다.You will be redirected to the Azure Management Portal where you sign in by using your Azure account credentials. 종속성과 함께 패키지를 배포하면 모든 종속성이 Azure Automation에 배포됩니다.Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. 패키지 메타데이터에 AzureAutomationNotSupported 태그를 추가하면 Azure Automation에 배포 단추를 해제할 수 있습니다.The 'Deploy to Azure Automation' button can be disabled by adding the AzureAutomationNotSupported tag to your package metadata.

Azure Automation에 대한 자세한 내용은 Azure Automation 설명서를 참조하세요.To learn more about Azure Automation, see the Azure Automation documentation.

PowerShell 갤러리에서 설치된 패키지를 업데이트하려면 [Update-Module][] 또는 [Update-Script][] cmdlet을 실행합니다.To update packages installed from the PowerShell Gallery, run either the [Update-Module][] or [Update-Script][] cmdlet. 추가 매개 변수 없이 실행하면 [Update-Module][]이 Install-Module을 실행하여 설치된 각 모듈을 업데이트하려고 합니다.When run without any additional parameters, [Update-Module][] attempts to update each module installed by running Install-Module. 모듈을 선택적으로 업데이트하려면 -Name 매개 변수를 추가합니다.To selectively update modules, add the -Name parameter.

마찬가지로, 추가 매개 변수 없이 실행하면 [Update-Script][]는 Install-Script를 실행하여 설치된 각 스크립트를 업데이트하려고 합니다.Similarly, when run without any additional parameters, [Update-Script][] also attempts to update each script installed by running Install-Script. 스크립트를 선택적으로 업데이트하려면 -Name 매개 변수를 추가합니다.To selectively update scripts, add the -Name parameter.

PowerShell 갤러리에서 설치한 모듈을 찾으려면 Get-InstalledModule cmdlet을 실행합니다.To find out which modules you have installed from the PowerShell Gallery, run the Get-InstalledModule cmdlet. 이 명령은 PowerShell 갤러리에서 직접 설치된 시스템의 모듈을 모두 나열합니다.This command lists all of the modules you have on your system that were installed directly from the PowerShell Gallery.

마찬가지로, PowerShell 갤러리에서 설치한 스크립트를 찾으려면 Get-InstalledScript cmdlet을 실행합니다.Similarly, to find out which scripts you have installed from the PowerShell Gallery, run the Get-InstalledScript cmdlet. 이 명령은 PowerShell 갤러리에서 직접 설치된 시스템의 스크립트를 모두 나열합니다.This command lists all of the scripts you have on your system that were installed directly from the PowerShell Gallery.