PowerShell 갤러리에서 Runbook 및 모듈 사용Use runbooks and modules in PowerShell Gallery

Azure Automation에서 사용자 고유의 Runbook 및 모듈을 만드는 대신 Microsoft 및 커뮤니티에서 이미 빌드한 시나리오에 액세스할 수 있습니다.Rather than creating your own runbooks and modules in Azure Automation, you can access scenarios that have already been built by Microsoft and the community. Azure Automation GitHub 조직의 PowerShell 갤러리 및 Python runbook 에서 PowerShell runbook 및 모듈 을 가져올 수 있습니다.You can get PowerShell runbooks and modules from the PowerShell Gallery and Python runbooks from the Azure Automation GitHub organization. 자신이 개발한 시나리오를 공유하여 커뮤니티에 기여할 수도 있습니다.You can also contribute to the community by sharing scenarios that you develop.

참고

TechNet 스크립트 센터를 사용 중지 하 고 있습니다.The TechNet Script Center is retiring. Runbook 갤러리에 있는 스크립트 센터의 모든 runbook은 Automation GitHub 조직 으로 이동 되었습니다. 자세한 내용은 여기를 참조 하세요.All of the runbooks from Script Center in the Runbook gallery have been moved to our Automation GitHub organization For more information, see here.

PowerShell 갤러리는 Microsoft 및 커뮤니티에서 만든 다양한 Runbook을 제공하며, 이를 Azure Automation으로 가져올 수 있습니다.The PowerShell Gallery provides a variety of runbooks from Microsoft and the community that you can import into Azure Automation. Runbook을 사용하려면 갤러리에서 Runbook을 다운로드하거나, Azure Portal을 사용하여 갤러리에서 또는 Automation 계정에서 Runbook을 직접 가져올 수 있습니다.To use one, download a runbook from the gallery, or you can directly import runbooks from the gallery, or from your Automation account in the Azure portal.

참고

그래픽 Runbook은 PowerShell 갤러리에서 지원되지 않습니다.Graphical runbooks are not supported in PowerShell Gallery.

PowerShell 갤러리에서 직접 가져오는 것은 Azure Portal을 사용하는 경우에만 가능하며,You can only import directly from the PowerShell Gallery using the Azure portal. PowerShell을 사용하여 직접 가져올 수 없습니다.You cannot perform this function using PowerShell.

참고

프로덕션 환경에서 설치 및 실행할 때는 PowerShell 갤러리에서 가져온 Runbook 내용의 유효성을 검사해야 하며 세심한 주의가 필요합니다.You should validate the contents of any runbooks that you get from the PowerShell Gallery and use extreme caution in installing and running them in a production environment.

PowerShell 모듈에는 runbook에서 사용할 수 있는 cmdlet이 포함 되어 있습니다.PowerShell modules contain cmdlets that you can use in your runbooks. Azure Automation에서 설치할 수 있는 기존 모듈은 PowerShell 갤러리에서 사용할 수 있습니다.Existing modules that you can install in Azure Automation are available in the PowerShell Gallery. Azure Portal에서이 갤러리를 시작 하 고 모듈을 Azure Automation에 직접 설치 하거나 수동으로 다운로드 하 여 설치할 수 있습니다.You can launch this gallery from the Azure portal and install the modules directly into Azure Automation, or you can manually download and install them.

아래 목록에는 일반적인 시나리오를 지원하는 몇 가지 Runbook이 포함되어 있습니다.The list below contains a few runbooks that support common scenarios. Azure Automation 팀에서 만든 Runbook의 전체 목록은 AzureAutomationTeam 프로필을 참조하세요.For a full list of runbooks created by the Azure Automation team, see AzureAutomationTeam profile.

  1. Azure Portal에서 Automation 계정을 엽니다.In the Azure portal, open your Automation account.

  2. 프로세스 자동화 에서 Runbook 갤러리 를 선택합니다.Select Runbooks gallery under Process Automation.

  3. 원본: PowerShell 갤러리 를 선택합니다.Select Source: PowerShell Gallery. 그러면 찾아볼 수 있는 사용 가능한 runbook의 목록이 표시 됩니다.This shows a list of available runbooks that you can browse.

  4. 목록 위의 검색 상자를 사용 하 여 목록의 범위를 좁힐 수 있습니다. 또는 필터를 사용 하 여 게시자, 유형 및 정렬 별로 표시 범위를 좁힐 수 있습니다.You can use the search box above the list to narrow the list, or you can use the filters to narrow the display by publisher, type, and sort. 원하는 갤러리 항목을 찾아 선택하여 세부 정보를 확인합니다.Locate the gallery item you want and select it to view its details.

    Runbook 갤러리 탐색

  5. 항목을 가져오려면 세부 정보 블레이드에서 가져오기 를 클릭 합니다.To import an item, click Import on the details blade.

    Runbook 갤러리 항목 세부 정보를 표시 합니다.

  6. 선택적으로 Runbook의 이름을 변경한 다음 확인 을 클릭하여 해당 Runbook을 가져옵니다.Optionally, change the name of the runbook and then click OK to import the runbook.

  7. 이 Runbook은 Automation 계정의 Runbook 탭에 표시됩니다.The runbook appears on the Runbooks tab for the Automation account.

Azure Portal를 사용 하 여 GitHub에서 PowerShell runbook 가져오기Import a PowerShell runbook from GitHub with the Azure portal

  1. Azure Portal에서 Automation 계정을 엽니다.In the Azure portal, open your Automation account.

  2. 프로세스 자동화 에서 Runbook 갤러리 를 선택합니다.Select Runbooks gallery under Process Automation.

  3. 원본: GitHub 를 선택 합니다.Select Source: GitHub.

  4. 목록 위의 필터를 사용 하 여 게시자, 유형 및 정렬 별로 표시 범위를 좁힐 수 있습니다.You can use the filters above the list to narrow the display by publisher, type, and sort. 원하는 갤러리 항목을 찾아 선택하여 세부 정보를 확인합니다.Locate the gallery item you want and select it to view its details.

    GitHub 갤러리 탐색

  5. 항목을 가져오려면 세부 정보 블레이드에서 가져오기 를 클릭 합니다.To import an item, click Import on the details blade.

    GitHub 갤러리의 runbook에 대 한 자세한 뷰입니다.

  6. 선택적으로 Runbook의 이름을 변경한 다음 확인 을 클릭하여 해당 Runbook을 가져옵니다.Optionally, change the name of the runbook and then click OK to import the runbook.

  7. 이 Runbook은 Automation 계정의 Runbook 탭에 표시됩니다.The runbook appears on the Runbooks tab for the Automation account.

Microsoft에서는 다른 고객에게 유용하다고 생각하는 Runbook을 PowerShell 갤러리에 추가하도록 장려하고 있습니다.Microsoft encourages you to add runbooks to the PowerShell Gallery that you think would be useful to other customers. PowerShell 갤러리에서는 PowerShell 모듈 및 PowerShell 스크립트를 게시할 수 있습니다.The PowerShell Gallery accepts PowerShell modules and PowerShell scripts. Runbook을 PowerShell 갤러리에 업로드하여 추가할 수 있습니다.You can add a runbook by uploading it to the PowerShell Gallery.

  1. Azure Portal에서 Automation 계정을 엽니다.In the Azure portal, open your Automation account.

  2. 공유 리소스 아래에서 모듈 을 선택하여 모듈 목록을 엽니다.Select Modules under Shared Resources to open the list of modules.

  3. 페이지 위쪽에서 갤러리 찾아보기 를 클릭합니다.Click Browse gallery from the top of the page.

    모듈 갤러리의 뷰입니다.

  4. 갤러리 찾아보기 페이지에서 검색 상자를 사용 하 여 다음 필드 중 하나에서 일치 항목을 찾을 수 있습니다.On the Browse gallery page, you can use the search box to find matches in any of the following fields:

    • 모듈 이름Module Name
    • 태그들Tags
    • 작성자Author
    • Cmdlet/DSC 리소스 이름Cmdlet/DSC resource name
  5. 관심이 있는 모듈을 찾아 선택하여 세부 내용을 확인합니다.Locate a module that you're interested in and select it to view its details.

    특정 모듈로 드릴하면 자세한 정보를 확인할 수 있습니다.When you drill into a specific module, you can view more information. 이 정보에는 PowerShell 갤러리로 돌아가는 링크, 필요한 종속성 및 모듈에 속하는 모든 cmdlet 또는 DSC 리소스가 포함됩니다.This information includes a link back to the PowerShell Gallery, any required dependencies, and all of the cmdlets or DSC resources that the module contains.

    갤러리의 모듈에 대 한 자세한 뷰입니다.

  6. Azure Automation에 직접 모듈을 설치하려면 가져오기 를 클릭합니다.To install the module directly into Azure Automation, click Import.

  7. 가져오기 창에서 가져올 모듈의 이름을 확인할 수 있습니다.On the Import pane, you can see the name of the module to import. 모든 종속성이 설치되면 확인 단추가 활성화됩니다.If all the dependencies are installed, the OK button is activated. 종속성이 없는 경우 해당 종속성을 가져와야만 이 모듈을 가져올 수 있습니다.If you're missing dependencies, you need to import those dependencies before you can import this module.

  8. 가져오기 창에서 확인 을 클릭하여 모듈을 가져옵니다.On the Import pane, click OK to import the module. Azure Automation에서 모듈을 계정에 가져오는 동안 모듈 및 cmdlet에 대한 메타데이터를 추출합니다.While Azure Automation imports a module to your account, it extracts metadata about the module and the cmdlets. 각 활동을 추출해야 하므로 이 작업에는 몇 분 정도 걸릴 수 있습니다.This action might take a couple of minutes since each activity needs to be extracted.

  9. 모듈이 배포 중임을 알리는 초기 알림 및 완료 시의 다른 알림이 표시됩니다.You receive an initial notification that the module is being deployed and another notification when it has completed.

  10. 모듈 가져오기가 완료되면 사용 가능한 활동을 볼 수 있습니다.After the module is imported, you can see the available activities. Runbook 및 DSC 리소스에서 모듈 리소스를 사용할 수 있습니다.You can use module resources in your runbooks and DSC resources.

참고

PowerShell 코어만 지원하는 모듈은 Azure Automation에서 지원되지 않으며, Azure Portal에서 가져오거나 PowerShell 갤러리에서 직접 배포할 수 없습니다.Modules that only support PowerShell core are not supported in Azure Automation and are unable to be imported in the Azure portal, or deployed directly from the PowerShell Gallery.

Python Runbook 사용Use Python runbooks

Python Runbook은 Azure Automation GitHub 조직에서 사용할 수 있습니다.Python Runbooks are available in the Azure Automation GitHub organization. GitHub 리포지토리에 참가할 때 참여를 업로드할 때 태그 (Github 토픽): Python3 를 추가 합니다.When you contribute to our GitHub repo, add the tag (GitHub Topic) : Python3 when you upload your contribution.

Runbook 또는 모듈 요청Request a runbook or module

사용자 음성에 요청을 보낼 수 있습니다.You can send requests to User Voice. Runbook을 작성하는 데 도움이 필요하거나 PowerShell에 대한 질문이 있으면 Microsoft Q&A 질문 페이지에 질문을 게시하세요.If you need help with writing a runbook or have a question about PowerShell, post a question to our Microsoft Q&A question page.

다음 단계Next steps