PowerShell용 MID 서버 매개변수

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 6분
  • 매개변수는 특정 MID 서버의 동작을 제어하며 MID 서버 속성보다 우선순위가 낮습니다.

    다음 매개변수는 선택 사항입니다.
    주:
    매개변수의 설정을 변경한 후에는 MID 서버 서비스를 다시 시작해야 합니다.
    이름 설명
    mid.powershell_api.session_pool.max_size

    세션 풀에 허용되는 최대 세션 수를 지정합니다.

    주:
    이 매개변수를 설정하거나 변경하려면 MID 서버를 다시 시작해야 합니다.
    • 유형: 정수
    • 기본값: 25
    mid.powershell_api.session_pool.target.max_size

    풀에 허용되는 대상 호스트당 최대 세션 수를 지정합니다.

    주:
    이 매개변수를 설정하거나 변경하려면 MID 서버를 다시 시작해야 합니다.
    • 유형: 정수
    • 기본값: 3
    mid powershell_api use_ssl WinRM을 사용하는 HTTPS 연결에 SSL 인증서를 사용해야 합니다.
    • 유형: True | False
    • 기본값: false
    mid powershell_api additional_pssesion_options PSSession에 대한 고급 옵션을 통제합니다. 고급 PSSession 옵션에 대한 자세한 내용은 https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/new-pssessionoption?view=powershell-6 문서를 참조하십시오.
    mid powershell_api remote_https_port HTTP를 통해 PowerShell을 사용하여 Windows 서버에 연결하는 포트를 구성합니다.
    • 유형: 정수
    • 기본값: 5986
    mid.powershell_api.winrm.remote_port HTTP를 통해 PowerShell을 사용하여 Windows 서버에 연결하는 포트를 구성합니다.
    • 유형: 정수
    • 기본값: 5985
    mid powershell_api skip_ssl_cert_check HTTPS 연결에 WinRM을 사용하는 경우 SSL 인증서 확인을 건너뜁니다.
    • 유형: True | False
    • 기본값: false
    mid powershell_api skip_ssl_cert_check_options
    HTTPS 연결에 WinRM을 사용하는 경우 특정 SSL 인증서 확인을 건너뜁니다. CA(인증 기관)의 인증서, 인증서와 연결된 호스트를 식별하는 CN(일반 이름)의 인증서, 해지된 인증서에 대한 인증서 검사를 건너뛰도록 MID 서버를 구성합니다.
    • 유형: 문자열
    • 기본값: -SkipCACheck -SkipCNCheck -SkipRevocationCheck
    mid.powershell_api.wmi.use_reverse_dns_lookup

    WMI 프로토콜을 사용하여 Windows 대상 장치와 통신할 때 Kerberos 인증을 활용하려면 이 속성을 활성화합니다. 활성화되면 시스템이 IP 주소의 역방향 DNS 조회를 수행하여 IP 주소 대신 FQDN(전체 주소 도메인 이름)을 사용할 수 있도록 합니다. 이렇게 하면 Kerberos 인증을 용이하게 할 수 있습니다.

    주:
    참고: 역방향 DNS 조회가 실패하면 시스템이 IP 주소를 사용하도록 되돌릴 수 있습니다. 또한 IP 주소에서 역방향 DNS 조회를 수행하면 성능에 영향을 줄 수 있습니다.
    • 유형: True | False

    • 기본값: False

    mid.powershell.use_credentials
    PowerShell과 디스커버리에서 사용할 자격 증명을 결정합니다. True 설정은 자격 증명 테이블의 Windows 자격 증명으로 프로브를 실행하도록 MID 서버에 지시합니다. MID 서버 서비스에 대한 사용자의 자격 증명으로 프로브를 실행하려면 이 매개변수를 False로 설정합니다.
    • 유형: true | false
    • 기본값: true
    mid use_powershell
    디스커버리에 대해 PowerShell을 사용하거나 사용하지 않습니다. 값을 변경한 후 MID 서버를 다시 시작합니다. PowerShell이 설치되어 있지 않거나 설치된 버전이 2.0보다 낮은 버전인 경우 디스커버리는 WMIRunner 사용으로 돌아갑니다.
    • 유형: true | false
    • 기본값: true
    mid.powershell.path

    두 개 이상의 PowerShell이 설치된 경우 관리자가 MID 서버에서 특정 PowerShell을 가리키도록 할 수 있습니다. 실행 가능한 PowerShell이 포함된 폴더의 경로를 제공합니다(예: C:\mypowershell 또는 C:\mypowershell\). ServiceNow는 자동으로 스트링 powershell.exe를 경로에 추가합니다. 32비트 및 64비트 PowerShell이 동일한 MID 서버에서 활성화될 때 이 매개변수를 구성하며, 이는 컨텍스트에 대한 올바른 PowerShell을 실행하는 데 중요합니다. 64비트 Windows는 파일 시스템 리디렉션을 이용하며 MID 서버는 32비트 애플리케이션으로 실행됩니다. %WinDir%\System32에 경로를 지정하려고 하면 Windows가 자동으로%WinDir%\SysWOW64로 리디렉션됩니다. 리디렉션을 방지하려면 경로를 %WinDir%\Sysnative로 지정하십시오. 예를 들어 C:\WINDOWS\system32\WindowsPowerShell\v1.0\ 대신 C:\WINDOWS\sysnative\WindowsPowerShell\v1.0\를 지정합니다.

    주:
    64비트 버전의 Windows XP에서 사용하려면 Microsoft 핫픽스가 필요할 수 있습니다.

    64비트 Windows 머신에서 실행되는 애플리케이션을 검색하려면 MID 서버가 64비트 windows 호스트 머신에서 실행되고 있어야 합니다.

    • 유형: 문자열(경로)
    • 기본값: 없음
    mid.powershell.enforce_utf8 대상 Windows 시스템에 명령하여 UTF-8로 인코딩된 출력을 반환하도록 하려면 이 매개변수를 사용합니다. 이 기능을 사용하지 않으면 대상 시스템에서 기본 인코딩을 사용할 수 있습니다. 이 매개변수는 PowerShell을 사용하는 경우에만 유효합니다.

    이 값을 False로 설정하면 프로브에서 비 ASCII 문자가 반환될 때 CMDB에 잘못된 값이 생성될 수 있습니다.

    • 유형: true | false
    • 기본값: true
    mid.powershell.local_mid_service_credential_fallback 다른 모든 자격 증명이 실패하는 경우 MID 서버가 사용하는 로그인 자격 증명을 지정합니다.
    • 유형: True | False
    • 기본값: true
    mid.powershell_api.idle_session_timeout

    유휴 Powershell 세션의 시간 제한 값(초)을 지정합니다.

    주:
    이 매개변수를 설정하거나 변경하려면 MID 서버를 다시 시작해야 합니다.
    • 유형: 정수
    • 기본값: 60
    mid.powershell.command.parameter_passing 이 매개변수를 활성화하여 명령 라인에서 PowerShell 매개변수 전달을 허용합니다.
    • 유형: True | False
    • 기본값: False
    중간. powershell. parameter_passing 이 매개변수를 활성화하여 명령 라인에서 PowerShell 스크립트 전달을 허용합니다.
    • 유형: True | False
    • 기본값: false
    mid.windows.management_protocol
    장치에 사용된 Windows 관리 프로토콜을 선택하고 분류를 처리하려면 관리자를 활성화합니다. 옵션은 다음과 같습니다.
    • WMI
    • WinRM
    • 유형: 문자열
    • 기본값: WMI
    mid.windows.probe_timeout 특정 MID 서버의 모든 Windows 프로브에 대한 시간 제한 간격을 설정합니다. 이 값은 개별 프로브에 대해 wmi_timeout 프로브 매개변수로 구성된 값에 의해 무효화됩니다.
    • 유형: 정수
    • 기본값: 600