다음을 통해 공유

Configuration Manager cmdlet 시작

  • 아티클

적용 대상: Configuration Manager(현재 분기)

Windows PowerShell 사용하여 Configuration Manager 계층을 관리합니다. PowerShell 스크립트를 사용하여 WMI 및 C#을 사용하여 문서화된 다른 접근 방식과 유사한 Configuration Manager 자동화하거나 확장할 수 있습니다. 자세한 내용은 Configuration Manager SDK를 참조하세요.

Configuration Manager 콘솔 또는 Windows PowerShell 세션에서 PowerShell에서 Configuration Manager cmdlet 및 스크립트를 실행합니다. Configuration Manager 콘솔을 사용하여 Configuration Manager cmdlet을 실행하면 세션이 사이트의 컨텍스트에서 자동으로 실행됩니다.

참고

현재 지원되는 모든 버전의 Configuration Manager 현재 분기는 버전 5.1을 Windows PowerShell 지원합니다. PowerShell 버전 7을 이미 설치한 경우에도 PowerShell 버전 5.1을 사용할 수 있습니다. 자세한 내용은 PowerShell 7을 Windows PowerShell 5.1과 함께 사용을 참조하세요.

Configuration Manager PowerShell cmdlet 라이브러리는 PowerShell 7을 지원합니다. 자세한 내용은 PowerShell 버전 7에 대한 지원을 참조하세요.

버전 2103부터 ConfigurationManager PowerShell 모듈에는 Microsoft .NET 버전 4.7.2 이상이 필요합니다.

Configuration Manager 콘솔의 PowerShell

PowerShell을 여는 가장 쉬운 방법은 Configuration Manager 콘솔에서 직접 사용하는 것입니다.

  1. Configuration Manager 콘솔을 시작합니다. 왼쪽 위 모서리에는 파란색 사각형이 있습니다. 파란색 사각형에서 흰색 화살표를 선택하고 Windows PowerShell 통해 연결을 선택합니다.

  2. Windows PowerShell 로드되면 사이트 코드가 포함된 프롬프트가 표시됩니다. 예를 들어 사이트 코드가 "ABC"인 경우 프롬프트는 다음과 같습니다. PS ABC:\>

  3. 작동하는지 확인하려면 Get-CMSite cmdlet을 사용합니다. 이 cmdlet은 현재 연결된 Configuration Manager 사이트 및 모든 자식 사이트에 대한 정보를 반환합니다. 예를 들어 사이트 서버 이름, 설치 디렉터, 사이트 이름 및 버전입니다.

참고

Configuration Manager 콘솔에서 PowerShell 또는 PowerShell ISE를 시작하면 프로세스 범위에 AllSigned 실행 정책을 사용합니다. 이 기본 보안 구성이 사용자 환경에 너무 많은 경우 이 구성을 해결하는 두 가지 옵션이 있습니다.

Configuration Manager PowerShell 모듈 가져오기

Configuration Manager 모듈을 수동으로 로드하여 기존 Windows PowerShell 세션에서 Configuration Manager 연결합니다.

  1. 시작 메뉴에서 Windows PowerShell 세션을 엽니다.

  2. Import-Module cmdlet을 사용하여 Configuration Manager 모듈을 가져옵니다. Configuration Manager 모듈의 경로를 지정하거나 모듈이 포함된 디렉터리로 변경합니다. 기본적으로 모듈은 다음 경로에 있습니다. C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\ConfigurationManager.psd1

    버전 2111부터 Configuration Manager 콘솔을 설치하면 모듈의 경로가 이제 시스템 환경 변수인 PSModulePath에 추가됩니다. 자세한 내용은 about_PSModulePath 참조하세요. 이 변경으로 모듈을 이름만으로 가져올 수 있습니다. Import-Module ConfigurationManager

    중요

    다른 폴더에 있을 수 있는 이전 버전의 모듈을 가져오지 않도록 합니다. 모듈을 가져온 후 다음 명령을 사용하여 모듈 버전 및 경로를 확인합니다.

    (Get-Module -Name ConfigurationManager).Version
(Get-Module -Name ConfigurationManager).Path

    다음 예제에서는 모듈의 디렉터리를 변경한 다음 가져옵니다.

    Set-Location 'C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin'
Import-Module .\ConfigurationManager.psd1

    팁

    SMS_ADMIN_UI_PATH 환경 변수를 사용할 수도 있습니다. 예시:

    Set-Location "$env:SMS_ADMIN_UI_PATH\..\"

    또한 cd 별칭을 사용하여 Set-Location cmdlet 대신 디렉터리를 변경할 수 있습니다.

  3. 이 컴퓨터에서 Configuration Manager 모듈을 처음 가져오는 경우 사이트 드라이브를 만들어야 할 수 있습니다. 예를 들어:

    New-PSDrive -Name "ABC" -PSProvider "CMSite" -Root "siteserver.contoso.com" -Description "Primary site"

    팁

    콘솔에서 PowerShell을 시작하면 현재 연결된 사이트의 편의를 위해 PSDrive가 자동으로 만들어집니다. 계층 구조에 있는 경우 New-PSDrive 를 사용하여 각 사이트에 대한 드라이브를 만듭니다.

  4. Configuration Manager cmdlet을 실행하려면 경로를 Configuration Manager 사이트로 전환해야 합니다. 다음 예제에서 사이트 코드는 입니다.ABC

    Set-Location ABC:

  5. PowerShell이 Get-CMSite cmdlet을 사용하여 Configuration Manager 모듈을 제대로 로드했는지 확인합니다.

도움말 업데이트

Configuration Manager PowerShell 모듈에 대한 최신 정보를 얻으려면 Update-Help cmdlet을 사용합니다. 이 콘텐츠는 ConfigurationManager 모듈용 Microsoft Learn에 게시된 내용과 동일합니다.

중요

업데이트 가능한 콘텐츠가 구성되고 버전 2103 릴리스와 함께 게시되는 방식이 변경되었으므로 버전 2010 사이트에서 Update-Help 를 사용하지 마세요. 사이트를 버전 2103 이상으로 업데이트한 다음 로컬 도움말 콘텐츠를 업데이트합니다.

자세한 내용은 PowerShell 버전 2103 릴리스 정보를 참조하세요.

이 cmdlet을 실행하는 컴퓨터에는 인터넷 액세스, 특히 pshelpprod.blob.core.windows.net이 필요합니다. 그런 다음 관리자 권한 PowerShell 세션에서 다음 명령을 실행합니다.

Update-Help -Module ConfigurationManager

Configuration Manager cmdlet 도움말을 업데이트한 후 Get-Help cmdlet을 사용하여 cmdlet에 대한 도움말을 볼 수 있습니다. 예시:

Get-Help Get-CMDevice
Get-Help Get-CMDevice -Examples
Get-Help Get-CMDevice -Parameter *

자세한 내용은 다음 PowerShell 블로그 게시물: 도움말이 있습니다!를 참조하세요.

일반 매개 변수

모든 Configuration Manager cmdlet은 일반적인 PowerShell 매개 변수를 지원합니다.

  • 디버그
  • ErrorAction
  • ErrorVariable
  • InformationAction
  • InformationVariable
  • OutVariable
  • OutBuffer
  • PipelineVariable
  • 자세한 정보
  • WarningAction
  • WarningVariable

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

PowerShell 버전 7 지원

Configuration Manager PowerShell cmdlet 라이브러리는 PowerShell 버전 7을 지원합니다. 다운로드 및 설치 방법에 대한 지침을 포함하여 PowerShell 7에 대한 자세한 내용은 Windows에 PowerShell 설치를 참조하세요.

팁

PowerShell 7은 로 pwsh.exe실행됩니다. 이전 버전의 PowerShell은 로 powershell.exe실행됩니다.

PowerShell 버전 7을 지원하지 않는 Cmdlet

다음 cmdlet은 PowerShell 7을 지원하지 않습니다.

  • Import-CMPackage
  • Import-CMDriverPackage
  • Import-CMTaskSequence
  • Export-CMPackage
  • Export-CMDriverPackage
  • Export-CMTaskSequence
  • Add-CMReportingServicePoint
  • Get-CMReportingServicePoint
  • Remove-CMReportingServicePoint
  • Set-CMReportingServicePoint

PowerShell 버전 7과 함께 사용되는 .NET Core 대신 .NET Framework 필요합니다.

버전 2103부터 PowerShell 버전 7 세션에서 이러한 cmdlet을 사용하려고 하면 다음 오류와 함께 실패합니다. This cmdlet only supports the ".NET Framework" runtime.

PowerShell 버전 7의 알려진 문제

PowerShell에 대한 피드백

Configuration Manager PowerShell cmdlet에 대한 피드백이 있는 경우 Configuration Manager 콘솔에서 동일한 옵션을 사용하여 피드백을 보냅니다. 자세한 내용은 제품 피드백을 참조하세요.

찡그린 얼굴을 보낼 때 PowerShell과 관련된 다음 추가 정보를 포함합니다.

  • Microsoft에서 문제를 재현할 수 있도록 사용한 정확한 스크립트 또는 명령 구문입니다.

  • 실제 동작과 비교하여 예상한 동작입니다.

  • Verbose 공통 매개 변수를 사용하여 실행할 때의 전체 출력입니다.

  • ConfigurationManager 모듈의 버전 및 경로입니다. 예를 들어 다음 명령의 출력을 포함합니다.

    (Get-Module -Name ConfigurationManager).Version
(Get-Module -Name ConfigurationManager).Path

  • cmdlet에서 오류를 반환하는 경우 다음 명령을 사용하여 예외 세부 정보를 가져옵니다.

    $Error[0].Exception | Format-List * -Force

미리 보기 릴리스 정보

핵심 설명서 라이브러리의 기술 미리 보기 기능 문서에는 PowerShell에 대한 릴리스 정보가 포함되어 있습니다. 예를 들어 기술 미리 보기 버전 2202를 참조하세요.

다음 단계

Configuration Manager 최신 릴리스에서 변경된 내용에 대한 자세한 내용은 목차에서 최신 릴리스 정보를 선택합니다.

개별 cmdlet에 대한 자세한 내용은 Configuration Manager cmdlet 참조를 참조하세요.

Windows PowerShell 학습 및 시작에 대한 자세한 내용은 PowerShell 101을 참조하세요.