Microsoft MVP성태의 닷넷 이야기
닷넷: 2326. C# - PowerShell과 연동하는 방법 (두 번째 이야기) [링크 복사], [링크+제목 복사],
조회: 2371
글쓴 사람
정성태 (seongtaejeong at gmail.com)
홈페이지
첨부 파일
(연관된 글이 1개 있습니다.)
(시리즈 글이 4개 있습니다.)
Windows: 146. PowerShell로 원격 프로세스(EXE, BAT) 실행하는 방법
; https://www.sysnet.pe.kr/2/0/11450

개발 환경 구성: 738. PowerShell - 원격 호출 시 "powershell.exe"가 아닌 "pwsh.exe" 환경으로 명령어를 실행하는 방법
; https://www.sysnet.pe.kr/2/0/13858

닷넷: 2325. C# - PowerShell과 연동하는 방법
; https://www.sysnet.pe.kr/2/0/13892

닷넷: 2326. C# - PowerShell과 연동하는 방법 (두 번째 이야기)
; https://www.sysnet.pe.kr/2/0/13897




C# - PowerShell과 연동하는 방법 (두 번째 이야기)

이번에는 Get-VM 명령어로 예를 들어 볼까요? ^^

Get-VM
; https://learn.microsoft.com/en-us/powershell/module/hyper-v/get-vm

문서의 서두에 "Module: Hyper-V"라고 나오는데요, 즉 모듈명이 "Hyper-V"라는 것입니다. PowerShell의 경우 모듈은 PSModulePath에 등록된 경로에 있으므로,

PS C:\Windows\System32> $env:PSModulePath
C:\Users\testusr\Documents\WindowsPowerShell\Modules;...[생략]...

  • %USERPROFILE%\Documents\WindowsPowerShell\Modules;
  • C:\Program Files\WindowsPowerShell\Modules;
  • C:\WINDOWS\system32\WindowsPowerShell\v1.0\Modules\;
  • C:\Program Files (x86)\Microsoft SQL Server\130\Tools\PowerShell\Modules\;
  • C:\Program Files (x86)\Microsoft SQL Server\140\Tools\PowerShell\Modules\;
  • C:\Program Files\Microsoft Message Analyzer\PowerShell\

차례대로 저 경로에서 찾아보면 되는데, 제 시스템에서 Hyper-V 모듈은 다음 경로에 있었습니다.

C:\Windows\System32\WindowsPowerShell\v1.0\Modules\Hyper-V\2.0.0.0

저 폴더에는 Hyper-V.psd1 파일이 있고, 해당 파일을 열어보면 실제 구현을 담고 있는 DLL에 대한 정보가 있습니다. (물론, 모든 PowerShell 모듈이 이런 식으로 구성돼 있는 것은 아닙니다. ^^)

// Hyper-V.psd1
...[생략]...

# Script module or binary module file associated with this manifest
NestedModules = 'Microsoft.HyperV.PowerShell.Cmdlets.dll'
...[생략]...

그럼, 다시 저 DLL 파일을 아래의 경로에서 찾을 수 있고,

C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.HyperV.PowerShell.Cmdlets\v4.0_10.0.0.0__31bf3856ad364e35

대부분은 닷넷 어셈블리로 구현돼 있을 것이므로 dnSpy 등의 역어셈블 도구를 이용해 실제 구현이 어떻게 됐는지 확인할 수 있습니다.




해당 DLL을 역어셈블해 Get-VM 명령어를 보면 구현 자체는 다음과 같이 간단한데요,

using System;
using System.Collections.Generic;
using System.Diagnostics.CodeAnalysis;
using System.Linq;
using System.Management.Automation;
using Microsoft.HyperV.PowerShell.ExtensionMethods;
using Microsoft.Management.Infrastructure;
using Microsoft.Virtualization.Client.Management;

namespace Microsoft.HyperV.PowerShell.Commands
{
    [Cmdlet("Get", "VM", DefaultParameterSetName = "Name")]
    [OutputType(new Type[]
    {
        typeof(VirtualMachine)
    })]
    public sealed class GetVM : VirtualizationCmdlet<VirtualMachine>, IVmByNameCmdlet, IVirtualMachineCmdlet, IServerParameters, IParameterSet
    {
        [SuppressMessage("Microsoft.Performance", "CA1819:PropertiesShouldNotReturnArrays", Justification = "This is by spec.")]
        [ValidateNotNullOrEmpty]
        [Parameter(ParameterSetName = "Name", ValueFromPipeline = true, Position = 0)]
        [Alias(new string[]
        {
            "VMName"
        })]
        public string[] Name { get; set; }

        [SuppressMessage("Microsoft.Performance", "CA1819:PropertiesShouldNotReturnArrays", Justification = "This is by spec.")]
        [Parameter(ParameterSetName = "Name")]
        [Parameter(ParameterSetName = "Id")]
        [ValidateNotNullOrEmpty]
        public override CimSession[] CimSession { get; set; }

        [SuppressMessage("Microsoft.Performance", "CA1819:PropertiesShouldNotReturnArrays", Justification = "This is by spec.")]
        [Parameter(ParameterSetName = "Name")]
        [Parameter(ParameterSetName = "Id")]
        [ValidateNotNullOrEmpty]
        public override string[] ComputerName { get; set; }

        [SuppressMessage("Microsoft.Performance", "CA1819:PropertiesShouldNotReturnArrays", Justification = "This is by spec.")]
        [Parameter(ParameterSetName = "Name")]
        [Parameter(ParameterSetName = "Id")]
        [ValidateNotNullOrEmpty]
        [CredentialArray]
        public override PSCredential[] Credential { get; set; }

        [ValidateNotNull]
        [Parameter(ParameterSetName = "Id", ValueFromPipelineByPropertyName = true, ValueFromPipeline = true, Position = 0)]
        public Guid? Id { get; set; }

        [Parameter(ParameterSetName = "ClusterObject", Mandatory = true, Position = 0, ValueFromPipeline = true)]
        [ValidateNotNullOrEmpty]
        [PSTypeName("Microsoft.FailoverClusters.PowerShell.ClusterObject")]
        public PSObject ClusterObject { get; set; }

        internal override IList<VirtualMachine> EnumerateOperands(IOperationWatcher operationWatcher)
        {
            IList<VirtualMachine> result;
            if (base.CurrentParameterSetIs("Name"))
            {
                result = ParameterResolvers.ResolveVirtualMachines(this, operationWatcher, ErrorDisplayMode.WriteWarning);
            }
            else
            {
                if (!base.CurrentParameterSetIs("Id"))
                {
                    return GetVM.GetVirtualMachinesFromClusterObject(this.ClusterObject, operationWatcher).ToList<VirtualMachine>();
                }
                Guid vmId = this.Id.Value;
                result = ParameterResolvers.GetServers(this, operationWatcher).SelectWithLogging((Server server) => VirtualizationObjectLocator.GetVirtualMachineById(server, vmId), operationWatcher).ToList<VirtualMachine>();
            }
            return result;
        }

        internal override void ProcessOneOperand(VirtualMachine operand, IOperationWatcher operationWatcher)
        {
            operationWatcher.WriteObject(operand);
        }

        private static IEnumerable<VirtualMachine> GetVirtualMachinesFromClusterObject(PSObject clusterObject, IOperationWatcher operationWatcher)
        private static IEnumerable<VirtualMachine> GetVirtualMachinesFromClusterObject(PSObject clusterObject, IOperationWatcher operationWatcher)
        {
            object[] array = clusterObject.BaseObject as object[];
            if (array != null)
            {
                return array.Cast<PSObject>().SelectManyWithLogging((PSObject innerElement) => ClusterUtilities.GetVirtualMachinesFromClusterObject(innerElement, operationWatcher), operationWatcher);
            }
            IEnumerable<VirtualMachine> result;
            try
            {
                result = ClusterUtilities.GetVirtualMachinesFromClusterObject(clusterObject, operationWatcher);
            }
            catch (Exception e)
            {
                ExceptionHelper.DisplayErrorOnException(e, operationWatcher);
                result = Enumerable.Empty<VirtualMachine>();
            }
            return result;
        }
    }
}

느낌이 오시겠지만, 저걸 C# 프로젝트에서 직접 참조해 호출하는 것은 쉽지 않습니다. 왜냐하면, PowerShell 자체의 런타임 구성을 위한 여러 가지 부수적인 요소(호출 측 Credential 처리와 원격 호출, 명령 수행의 파이프라인 처리) 등이 관여하기 때문입니다.

따라서, 그냥 마이크로소프트에서 제공하는 어셈블리를 이용해 PowerShell 명령어를 호출하는 것이 훨씬 간단하고 안전합니다. ^^

C# - PowerShell과 연동하는 방법
; https://www.sysnet.pe.kr/2/0/13892


using System.Management.Automation;

// Install-Package System.Management.Automation
// Install-Package Microsoft.PowerShell.SDK

internal class Program
{
    static void Main(string[] args)
    {
        PowerShell _ps = PowerShell.Create();

        _ps.AddCommand("Get-VM", false);
        _ps.AddParameter("Name", new string[] { "win11en" });

        System.Collections.ObjectModel.Collection<PSObject> output = _ps.Invoke();

        foreach (var item in output)
        {
            dynamic vmObj = item;
            Console.WriteLine($"{vmObj.Name}: {vmObj.CPUUsage}%");
        }
    }
}

(지난 글에서도 언급했지만) "dynamic vmObj = item;"의 dynamic 대신 형식 안정성을 위해 Microsoft.HyperV.PowerShell.VirtualMachine 타입을 직접 쓰는 것도 가능합니다. 이를 위해서는 직접 참조/실행해 보면서 의존성 목록을 파악할 수 있는데, 제가 해 본 결과 Get-VM의 경우에는 어셈블리를 2개 참조해야 합니다.

// Microsoft.HyperV.PowerShell.Objects.dll
// C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.HyperV.PowerShell.Objects\v4.0_10.0.0.0__31bf3856ad364e35\Microsoft.HyperV.PowerShell.Objects.dll

// Microsoft.Virtualization.Client.Management.dll
// C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.Virtualization.Client.Management\v4.0_10.0.0.0__31bf3856ad364e35\Microsoft.Virtualization.Client.Management.dll

그럼, 다음과 같이 코드를 변경할 수 있습니다.

foreach (var item in output)
{
    if (item.BaseObject is Microsoft.HyperV.PowerShell.VirtualMachine vm)
    {
        Console.WriteLine($"{vm.Name}: {vm.CPUUsage}%");
    }                    
}

그런데, 이런 식으로 Microsoft.HyperV.PowerShell.VirtualMachine 타입을 사용하기 위해 "Microsoft.HyperV.PowerShell.Objects.dll"을 참조하는 것은 약간의 위험이 따릅니다. 가령, Windows 11 23H2에서 저 DLL의 버전은 10.0.22621.1인데요, 이것을 참조해 빌드한 후 산출된 어셈블리 디렉터리를 Windows 11 24H2에 복사해 실행하면 Invoke 코드에서 오류가 발생할 수 있습니다.

System.Collections.ObjectModel.Collection<PSObject> output = _ps.Invoke();
/* 예외 발생
System.Management.Automation.CommandNotFoundException: 'The 'Get-VM' command was found in the module 'Hyper-V', but the module could not be loaded due to the following error: [Could not load type 'Microsoft.HyperV.PowerShell.MemoryBackingType' from assembly 'Microsoft.HyperV.PowerShell.Objects, Version=10.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35'.]
For more information, run 'Import-Module Hyper-V'.'
*/

왜냐하면, Invoke 호출로 인해 Microsoft.PowerShell.SDK / System.Management.Automation은 GAC에 등록된 (24H2 윈도우 11에 설치된 10.0.26100.2033 버전의) Microsoft.HyperV.PowerShell.Cmdlets.dll을 로드하게 되고, 이 DLL은 동일하게 24H2에 설치된 10.0.26100.2033 버전의 Microsoft.HyperV.PowerShell.Objects.dll을 참조해 거기에만 있는 Microsoft.HyperV.PowerShell.MemoryBackingType에 의존하고 있기 때문입니다.

여기서 문제는, 23H2 환경에서 빌드했을 때 output 디렉터리에 위치하는 Microsoft.HyperV.PowerShell.Objects.dll은 10.0.22621.1 버전의 것이므로 Invoke 호출은 그 DLL을 선제적으로 로딩하게 되고, 결국 MemoryBackingType을 찾을 수 없어 예외가 발생하는 것입니다.

따라서 해당 DLL들은 실행 모듈과 같은 디렉터리에 복사하는 식으로 빌드해서는 안 되고 PowerShell.Invoke 호출의 내부 구현에 따라 자연스럽게 GAC로부터 로드되도록 맡겨야 합니다. 즉, Microsoft.HyperV.PowerShell.VirtualMachine 타입을 직접 사용하는 것은 지양해야 합니다. (아마도 이런 이유 때문에 해당 타입에 대한 문서를 제공하는 것이 어렵지 않은가... 싶습니다.)




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 3/5/2025]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




... 31  [32]  33  34  35  36  37  38  39  40  41  42  43  44  45  ...
NoWriterDateCnt.TitleFile(s)
13137정성태10/8/202214099.NET Framework: 2055. 리눅스 환경의 .NET Core 3/5+ 메모리 덤프로부터 닷넷 모듈을 추출하는 방법
13136정성태10/7/202214482.NET Framework: 2054. .NET Core/5+ SDK 설치 없이 dotnet-dump 사용하는 방법
13135정성태10/5/202214999.NET Framework: 2053. 리눅스 환경의 .NET Core 3/5+ 메모리 덤프를 분석하는 방법 - 두 번째 이야기 [1]
13134정성태10/4/202212201오류 유형: 820. There is a problem with AMD Radeon RX 5600 XT device. For more information, search for 'graphics device driver error code 31'
13133정성태10/4/202213332Windows: 211. Windows - (commit이 아닌) reserved 메모리 사용량 확인 방법 [1]
13132정성태10/3/202213374스크립트: 42. 파이썬 - latexify-py 패키지 소개 - 함수를 mathjax 식으로 표현
13131정성태10/3/202217185.NET Framework: 2052. C# - Windows Forms의 데이터 바인딩 지원(DataBinding, DataSource) [2]파일 다운로드1
13130정성태9/28/202212994.NET Framework: 2051. .NET Core/5+ - 에러 로깅을 위한 Middleware가 동작하지 않는 경우파일 다운로드1
13129정성태9/27/202213609.NET Framework: 2050. .NET Core를 IIS에서 호스팅하는 경우 .NET Framework CLR이 함께 로드되는 환경
13128정성태9/23/202216538C/C++: 158. Visual C++ - IDL 구문 중 "unsigned long"을 인식하지 못하는 #import [1]파일 다운로드1
13127정성태9/22/202214804Windows: 210. WSL에 systemd 도입
13126정성태9/15/202215330.NET Framework: 2049. C# 11 - 정적 메서드에 대한 delegate 처리 시 cache 적용
13125정성태9/14/202215747.NET Framework: 2048. C# 11 - 구조체 필드의 자동 초기화(auto-default structs)
13124정성태9/13/202215513.NET Framework: 2047. Golang, Python, C#에서의 CRC32 사용
13123정성태9/8/202215555.NET Framework: 2046. C# 11 - 멤버(속성/필드)에 지정할 수 있는 required 예약어 추가
13122정성태8/26/202215987.NET Framework: 2045. C# 11 - 메서드 매개 변수에 대한 nameof 지원
13121정성태8/23/202212400C/C++: 157. Golang - 구조체의 slice 필드를 Reflection을 이용해 변경하는 방법
13120정성태8/19/202215977Windows: 209. Windows NT Service에서 UI를 다루는 방법 [3]
13119정성태8/18/202215128.NET Framework: 2044. .NET Core/5+ 프로젝트에서 참조 DLL이 보관된 공통 디렉터리를 지정하는 방법
13118정성태8/18/202212670.NET Framework: 2043. WPF Color의 기본 색 영역은 (sRGB가 아닌) scRGB [2]
13117정성태8/17/202216312.NET Framework: 2042. C# 11 - 파일 범위 내에서 유효한 타입 정의 (File-local types)파일 다운로드1
13116정성태8/4/202216762.NET Framework: 2041. C# - Socket.Close 시 Socket.Receive 메서드에서 예외가 발생하는 문제파일 다운로드1
13115정성태8/3/202217323.NET Framework: 2040. C# - ValueTask와 Task의 성능 비교 [1]파일 다운로드1
13114정성태8/2/202217194.NET Framework: 2039. C# - Task와 비교해 본 ValueTask 사용법파일 다운로드1
13113정성태7/31/202216676.NET Framework: 2038. C# 11 - Span 타입에 대한 패턴 매칭 (Pattern matching on ReadOnlySpan<char>)
13112정성태7/30/202217559.NET Framework: 2037. C# 11 - 목록 패턴(List patterns) [1]파일 다운로드1
... 31  [32]  33  34  35  36  37  38  39  40  41  42  43  44  45  ...