Get-WSManInstance

모듈:

Microsoft.WsMan.Management

리소스 URI로 지정된 리소스 인스턴스에 대한 관리 정보를 표시합니다.

구문

Get-WSManInstance
   [-ApplicationName <String>]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-ResourceURI] <Uri>
   [-SelectorSet <Hashtable>]
   [-SessionOption <SessionOption>]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Get-WSManInstance
   [-ApplicationName <String>]
   [-BasePropertiesOnly]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Enumerate]
   [-Filter <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-Associations]
   [-ResourceURI] <Uri>
   [-ReturnType <String>]
   [-SessionOption <SessionOption>]
   [-Shallow]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Description

Get-WSManInstance cmdlet은 리소스 URI(Uniform Resource Identifier)로 지정된 관리 리소스의 인스턴스를 검색합니다. 검색되는 정보는 복잡한 XML 정보 집합( 개체 또는 단순 값)일 수 있습니다. 이 cmdlet은 표준 Web Services for Management(WS-Management) get 명령과 동일합니다.

이 cmdlet은 WS-Management 연결/전송 계층을 사용하여 정보를 검색합니다.

예제

예제 1: WMI에서 모든 정보 가져오기

PS C:\> Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="winrm"} -ComputerName "Server01"
xsi                     : http://www.w3.org/2001/XMLSchema-instance
p                       : https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim                     : http://schemas.dmtf.org/wbem/wscim/1/common
type                    : p:Win32_Service_Type
lang                    : en-US
AcceptPause             : false
AcceptStop              : true
Caption                 : Windows Remote Management (WS-Management)
CheckPoint              : 0
CreationClassName       : Win32_Service
Description             : Windows Remote Management (WinRM) service implements the WS-Management protocol for remote
management. WS-Management is a standard web services protocol used for remote software and
hardware management. The WinRM service listens on the network for WS-Management requests
and processes them. The WinRM Service needs to be configured with a listener using the
winrm.cmd command line tool or through Group Policy in order for it to listen over the
network. The WinRM service provides access to WMI data and enables event collection. Event
collection and subscription to events require that the service is running. WinRM messages
use HTTP and HTTPS as transports. The WinRM service does not depend on IIS but is
preconfigured to share a port with IIS on the same computer.  The WinRM service reserves the
/wsman URL prefix. To prevent conflicts with IIS, administrators should ensure that any
websites hosted on IIS do not use the /wsman URL prefix.
DesktopInteract         : false
DisplayName             : Windows Remote Management (WS-Management)
ErrorControl            : Normal
ExitCode                : 0
InstallDate             : InstallDate
Name                    : winrm
PathName                : C:\Windows\System32\svchost.exe -k NetworkService
ProcessId               : 948
ServiceSpecificExitCode : 0
ServiceType             : Share Process
Started                 : true
StartMode               : Auto
StartName               : NT AUTHORITY\NetworkService
State                   : Running
Status                  : OK
SystemCreationClassName : Win32_ComputerSystem
SystemName              : SERVER01
TagId                   : 0
WaitHint                : 0

이 명령은 WMI(Windows Management Instrumentation)에서 원격 server01 컴퓨터의 WinRM 서비스에 대해 노출하는 모든 정보를 반환합니다.

예제 2: Spooler 서비스의 상태 가져오기

PS C:\> Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="spooler"} -Fragment Status -ComputerName "Server01"
XmlFragment=OK

이 명령은 원격 server01 컴퓨터에서 Spooler 서비스의 상태만 반환합니다.

예제 3: 모든 서비스에 대한 엔드포인트 참조 가져오기

PS C:\> Get-WSManInstance -Enumerate -ResourceURI wmicimv2/win32_service -ReturnType EPR
xsi                     : http://www.w3.org/2001/XMLSchema-instance
p                       : https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim                     : http://schemas.dmtf.org/wbem/wscim/1/common
type                    : p:Win32_Service_Type
lang                    : en-US
AcceptPause             : false
AcceptStop              : false
Caption                 : Visual Studio 2008 Remote Debugger
CheckPoint              : 0
CreationClassName       : Win32_Service
Description             : Allows members of the Administrators group to remotely debug server applications using Visual
Studio 2008. Use the Visual Studio 2008 Remote Debugging Configuration Wizard to enable this
service.
DesktopInteract         : false
DisplayName             : Visual Studio 2008 Remote Debugger
ErrorControl            : Ignore
ExitCode                : 1077
InstallDate             : InstallDate
Name                    : msvsmon90
PathName                : "C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\Remote Debugger\x86\msvsmon.exe" /service msvsmon90
ProcessId               : 0
ServiceSpecificExitCode : 0
ServiceType             : Own Process
Started                 : false
StartMode               : Disabled
StartName               : LocalSystem
State                   : Stopped
Status                  : OK
SystemCreationClassName : Win32_ComputerSystem
SystemName              : COMPUTER01
TagId                   : 0
WaitHint                : 0
...

이 명령은 로컬 컴퓨터의 모든 서비스에 해당하는 엔드포인트 참조를 반환합니다.

예제 4: 지정된 조건을 충족하는 서비스 가져오기

PS C:\> Get-WSManInstance -Enumerate -ResourceURI wmicimv2/* -Filter "select * from win32_service where StartMode = 'Auto' and State = 'Stopped'" -ComputerName "Server01"
xsi                     : http://www.w3.org/2001/XMLSchema-instance
p                       : https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim                     : http://schemas.dmtf.org/wbem/wscim/1/common
type                    : p:Win32_Service_Type
lang                    : en-US
AcceptPause             : false
AcceptStop              : false
Caption                 : Windows Media Center Service Launcher
CheckPoint              : 0
CreationClassName       : Win32_Service
Description             : Starts Windows Media Center Scheduler and Windows Media Center Receiver services
at startup if TV is enabled within Windows Media Center.
DesktopInteract         : false
DisplayName             : Windows Media Center Service Launcher
ErrorControl            : Ignore
ExitCode                : 0
InstallDate             : InstallDate
Name                    : ehstart
PathName                : C:\Windows\system32\svchost.exe -k LocalServiceNoNetwork
ProcessId               : 0
ServiceSpecificExitCode : 0
ServiceType             : Share Process
Started                 : false
StartMode               : Auto
StartName               : NT AUTHORITY\LocalService
State                   : Stopped
Status                  : OK
SystemCreationClassName : Win32_ComputerSystem
SystemName              : Server01
TagId                   : 0
WaitHint                : 0
...

이 명령은 원격 Server01 컴퓨터에서 다음 조건을 충족하는 모든 서비스를 나열합니다.

• 서비스의 시작 유형이 자동입니다.
• 서비스가 중지되었습니다.

예제 5: 로컬 컴퓨터의 조건과 일치하는 수신기 구성 가져오기

PS C:\> Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"}
cfg                   : https://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTP
Port                  : 80
Hostname              :
Enabled               : true
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {100.0.0.1, 123.123.123.123, ::1, 2001:4898:0:fff:0:5efe:123.123.123.123...}

이 명령은 선택기 집합의 조건과 일치하는 수신기에 대한 로컬 컴퓨터의 WS-Management 수신기 구성을 나열합니다.

예제 6: 원격 컴퓨터의 조건과 일치하는 수신기 구성 가져오기

PS C:\> Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"} -ComputerName "Server01"
cfg                   : https://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTP
Port                  : 80
Hostname              :
Enabled               : true
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {100.0.0.1, 123.123.123.124, ::1, 2001:4898:0:fff:0:5efe:123.123.123.124...}

이 명령은 선택기 집합의 조건과 일치하는 수신기에 대한 원격 server01 컴퓨터의 WS-Management 수신기 구성을 나열합니다.

예제 7: 지정된 인스턴스와 관련된 연결된 인스턴스 가져오기

PS C:\> Get-WSManInstance -Enumerate -Dialect Association -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*
xsi                       : http://www.w3.org/2001/XMLSchema-instance
p                         : https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_ComputerSystem
cim                       : http://schemas.dmtf.org/wbem/wscim/1/common
type                      : p:Win32_ComputerSystem_Type
lang                      : en-US
AdminPasswordStatus       : 1
AutomaticManagedPagefile  : true
AutomaticResetBootOption  : true
AutomaticResetCapability  : true
BootOptionOnLimit         : BootOptionOnLimit
BootOptionOnWatchDog      : BootOptionOnWatchDog
BootROMSupported          : true
BootupState               : Normal boot
Caption                   : SERVER01
ChassisBootupState        : 3
CreationClassName         : Win32_ComputerSystem
CurrentTimeZone           : -480
DaylightInEffect          : false
Description               : AT/AT COMPATIBLE
DNSHostName               : server01
Domain                    : site01.corp.fabrikam.com
DomainRole                : 1
EnableDaylightSavingsTime : true
FrontPanelResetStatus     : 2
InfraredSupported         : false
InstallDate               : InstallDate
KeyboardPasswordStatus    : 2
LastLoadInfo              : LastLoadInfo
Manufacturer              : Dell Inc.
Model                     : OptiPlex 745
Name                      : SERVER01
NameFormat                : NameFormat
NetworkServerModeEnabled  : true
NumberOfLogicalProcessors : 2
NumberOfProcessors        : 1
OEMStringArray            : www.dell.com
PartOfDomain              : true
PauseAfterReset           : -1
PCSystemType              : 5
PowerManagementSupported  : PowerManagementSupported
PowerOnPasswordStatus     : 1
PowerState                : 0
PowerSupplyState          : 3
PrimaryOwnerContact       : PrimaryOwnerContact
PrimaryOwnerName          : testuser01
ResetCapability           : 1
ResetCount                : -1
ResetLimit                : -1
Roles                     : {LM_Workstation, LM_Server, SQLServer, NT}
Status                    : OK
SystemStartupDelay        : SystemStartupDelay
SystemStartupSetting      : SystemStartupSetting
SystemType                : X86-based PC
ThermalState              : 3
TotalPhysicalMemory       : 3217760256
UserName                  : FABRIKAM\testuser01
WakeUpType                : 6
Workgroup                 : Workgroup
xsi                     : http://www.w3.org/2001/XMLSchema-instance
p                       : https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim                     : http://schemas.dmtf.org/wbem/wscim/1/common
type                    : p:Win32_Service_Type
lang                    : en-US
AcceptPause             : false
AcceptStop              : false
Caption                 : Remote Procedure Call (RPC)
CheckPoint              : 0
CreationClassName       : Win32_Service
Description             : Serves as the endpoint mapper and COM Service Control Manager. If this service is stopped
or disabled, programs using COM or Remote Procedure Call (RPC) services will not function
properly.
DesktopInteract         : false
DisplayName             : Remote Procedure Call (RPC)
ErrorControl            : Normal
ExitCode                : 0
InstallDate             : InstallDate
Name                    : RpcSs
PathName                : C:\Windows\system32\svchost.exe -k rpcss
ProcessId               : 1100
ServiceSpecificExitCode : 0
ServiceType             : Share Process
Started                 : true
StartMode               : Auto
StartName               : NT AUTHORITY\NetworkService
State                   : Running
Status                  : OK
SystemCreationClassName : Win32_ComputerSystem
SystemName              : SERVER01
TagId                   : 0
WaitHint                : 0

xsi                     : http://www.w3.org/2001/XMLSchema-instance
p                       : https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_SystemDriver
cim                     : http://schemas.dmtf.org/wbem/wscim/1/common
type                    : p:Win32_SystemDriver_Type
lang                    : en-US
AcceptPause             : false
AcceptStop              : true
Caption                 : HTTP
CreationClassName       : Win32_SystemDriver
Description             : HTTP
DesktopInteract         : false
DisplayName             : HTTP
ErrorControl            : Normal
ExitCode                : 0
InstallDate             : InstallDate
Name                    : HTTP
PathName                : C:\Windows\system32\drivers\HTTP.sys
ServiceSpecificExitCode : 0
ServiceType             : Kernel Driver
Started                 : true
StartMode               : Manual
StartName               :
State                   : Running
Status                  : OK
SystemCreationClassName : Win32_ComputerSystem
SystemName              : SERVER01
TagId                   : 0

이 명령은 지정된 인스턴스(winrm)와 관련된 연결된 인스턴스를 가져옵니다.

예제와 같이 필터를 따옴표로 묶어야 합니다.

예제 8: 지정된 인스턴스와 관련된 연결 인스턴스 가져오기

PS C:\> Get-WSManInstance -Enumerate -Dialect Association -Associations -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

이 명령은 지정된 인스턴스(winrm)와 관련된 연결 인스턴스를 가져옵니다. 언어 값은 연결이고 Associations 매개 변수가 사용되므로 이 명령은 연결된 인스턴스가 아닌 연결 인스턴스를 반환합니다.

예제와 같이 필터를 따옴표로 묶어야 합니다.

매개 변수

-ApplicationName

연결에서 애플리케이션 이름을 지정합니다. ApplicationName 매개 변수의 기본값은 WSMAN입니다. 원격 엔드포인트의 전체 식별자는 다음과 같은 형식입니다.

<전송>://<서버>:<포트>/<ApplicationName>

예: http://server01:8080/WSMAN

세션을 호스트하는 IIS(인터넷 정보 서비스)는 이 엔드포인트가 있는 요청을 지정된 애플리케이션에 전달합니다. WSMAN의 이 기본 설정은 대부분의 용도에 적합합니다. 이 매개 변수는 많은 컴퓨터가 PowerShell을 실행하는 한 컴퓨터에 원격 연결을 설정하는 경우에 사용하도록 설계되었습니다. 이 경우 IIS는 효율성을 위해 WS-Management 호스트합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Associations

이 cmdlet은 연결된 인스턴스가 아닌 연결 인스턴스를 가져옵니다. Dialect 매개 변수에 Association 값이 있는 경우에만 이 매개 변수를 사용할 수 있습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Authentication

서버에서 사용할 인증 메커니즘을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• 기초의. 기본은 사용자 이름과 암호가 서버 또는 프록시에 명확한 텍스트로 전송되는 체계입니다.
• 기본값. WS-Management 프로토콜에 의해 구현된 인증 방법을 사용합니다. 기본값입니다.
• 소화하다. 다이제스트는 챌린지에 서버 지정 데이터 문자열을 사용하는 챌린지-응답 체계입니다.
• Kerberos. 클라이언트 컴퓨터와 서버는 Kerberos 인증서를 사용하여 상호 인증합니다.
• 교섭하다. 협상은 인증에 사용할 체계를 결정하기 위해 서버 또는 프록시와 협상하는 챌린지 응답 체계입니다. 예를 들어 이 매개 변수 값을 사용하면 협상을 통해 Kerberos 프로토콜 또는 NTLM이 사용되는지 여부를 확인할 수 있습니다.
• CredSSP. 사용자가 자격 증명을 위임할 수 있는 CredSSP(자격 증명 보안 지원 공급자) 인증을 사용합니다. 이 옵션은 한 원격 컴퓨터에서 실행되지만 다른 원격 컴퓨터에서 데이터를 수집하거나 다른 원격 컴퓨터에서 추가 명령을 실행하는 명령을 위해 설계되었습니다.

주의: CredSSP는 사용자 자격 증명을 로컬 컴퓨터에서 원격 컴퓨터로 위임합니다. 이렇게 하면 원격 작업의 보안 위험이 증가합니다. 원격 컴퓨터가 손상된 경우 자격 증명이 전달되면 자격 증명을 사용하여 네트워크 세션을 제어할 수 있습니다.

형식:	AuthenticationMechanism
별칭:	auth, am
허용되는 값:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BasePropertiesOnly

이 cmdlet은 ResourceURI 매개 변수로 지정된 기본 클래스의 일부인 속성만 열거한다는 것을 나타냅니다. Shallow 매개 변수가 지정된 경우에는 이 매개 변수가 적용되지 않습니다.

형식:	SwitchParameter
별칭:	UBPO, Base
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CertificateThumbprint

이 작업을 수행할 수 있는 권한이 있는 사용자 계정의 디지털 공개 키 인증서(X509)를 지정합니다. 인증서의 인증서 지문을 입력합니다.

인증서는 클라이언트 인증서 기반 인증에 사용됩니다. 로컬 사용자 계정에만 매핑할 수 있습니다. 도메인 계정에서 작동하지 않습니다.

인증서 지문을 가져오려면 PowerShell 인증서: 드라이브에서 Get-Item 또는 Get-ChildItem 명령을 사용합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ComputerName

관리 작업을 실행할 컴퓨터를 지정합니다. 값은 정규화된 도메인 이름, NetBIOS 이름 또는 IP 주소일 수 있습니다. 로컬 컴퓨터 이름을 사용하거나 localhost를 사용하거나 점(.)을 사용하여 로컬 컴퓨터를 지정합니다. 로컬 컴퓨터가 기본값입니다. 원격 컴퓨터가 사용자와 다른 도메인에 있는 경우 정규화된 도메인 이름을 사용해야 합니다. 이 매개 변수의 값을 cmdlet으로 파이프할 수 있습니다.

형식:	String
별칭:	CN
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ConnectionURI

연결 엔드포인트를 지정합니다. 이 문자열의 형식은 다음과 같습니다.

<전송>://<Server>:<포트>/<ApplicationName>

다음 문자열은 이 매개 변수에 대해 올바른 형식의 값입니다.

http://Server01:8080/WSMAN

URI는 정규화되어야 합니다.

형식:	Uri
별칭:	CURI, CU
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Credential

이 작업을 수행할 수 있는 권한이 있는 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다. User01, Domain01\User01 또는 User@Domain.com같은 사용자 이름을 입력합니다. 또는 Get-Credential cmdlet에서 반환된 개체와 같은 PSCredential 개체를 입력합니다. 사용자 이름을 입력하면 이 cmdlet에서 암호를 묻는 메시지를 표시합니다.

형식:	PSCredential
별칭:	cred, c
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Dialect

필터 조건자에서 사용할 방언을 지정합니다. 원격 서비스에서 지원하는 모든 언어일 수 있습니다. 방언 URI에는 다음 별칭을 사용할 수 있습니다.

• WQL https://schemas.microsoft.com/wbem/wsman/1/WQL
• 선택기 https://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• 연결 http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

형식:	Uri
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Enumerate

이 cmdlet은 관리 리소스의 모든 인스턴스를 반환한다는 것을 나타냅니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Filter

열거형에 대한 필터 식을 지정합니다. 이 매개 변수를 지정하는 경우 언어지정해야 합니다.

이 매개 변수의 유효한 값은 언어지정된 언어에 따라 달라집니다. 예를 들어 언어 WQL인 경우 Filter 매개 변수에는 문자열이 포함되어야 하며 문자열에는 다음 쿼리와 같은 유효한 WQL 쿼리가 포함되어야 합니다.

"Select * from Win32_Service where State != Running"

언어 연결인 경우 필터 문자열을 포함해야 하며 문자열에는 다음 필터와 같은 유효한 필터가 포함되어야 합니다.

-filter:Object=EPR\[;AssociationClassName=AssocClassName\]\[;ResultClassName=ClassName\]\[;Role=RefPropertyName\]\[;ResultRole=RefPropertyName\]}

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Fragment

지정된 작업에 대해 업데이트하거나 검색할 인스턴스 내의 섹션을 지정합니다. 예를 들어 스풀러 서비스의 상태를 얻으려면 다음을 지정합니다.

-Fragment Status

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-OptionSet

요청의 특성을 수정하거나 구체화하기 위한 서비스로의 스위치 집합을 지정합니다. 이러한 스위치는 서비스 관련이므로 명령줄 셸에서 사용되는 스위치와 유사합니다. 다양한 옵션을 지정할 수 있습니다.

다음 예제에서는 a, b 및 c 매개 변수의 값 1, 2 및 3을 전달하는 구문을 보여 줍니다.

-OptionSet @{a=1;b=2;c=3}

형식:	Hashtable
별칭:	OS
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Port

클라이언트가 WinRM 서비스에 연결할 때 사용할 포트를 지정합니다. 전송이 HTTP인 경우 기본 포트는 80입니다. 전송이 HTTPS인 경우 기본 포트는 443입니다.

HTTPS를 전송으로 사용하는 경우 ComputerName 매개 변수의 값이 서버의 CN(인증서 일반 이름)과 일치해야 합니다. 그러나 SkipCNCheck 매개 변수가 SessionOption 매개 변수의 일부로 지정된 경우 서버의 인증서 일반 이름이 서버의 호스트 이름과 일치하지 않아도됩니다. SkipCNCheck 매개 변수는 신뢰할 수 있는 컴퓨터에만 사용해야 합니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ResourceURI

리소스 클래스 또는 인스턴스의 URI를 지정합니다. URI는 컴퓨터에서 디스크 또는 프로세스와 같은 특정 유형의 리소스를 식별합니다.

URI는 접두사 및 리소스의 경로로 구성됩니다. 예를 들어:

https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

형식:	Uri
별칭:	RURI
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ReturnType

반환할 데이터의 형식을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• 객체
• EPR
• ObjectAndEPR

기본값은 Object입니다.

Object를 지정하거나 이 매개 변수를 지정하지 않으면 이 cmdlet은 개체만 반환합니다. EPR(엔드포인트 참조)을 지정하는 경우 이 cmdlet은 개체의 엔드포인트 참조만 반환합니다. 엔드포인트 참조에는 인스턴스의 리소스 URI 및 선택기에 대한 정보가 포함됩니다. ObjectAndEPR을 지정하는 경우 이 cmdlet은 개체와 연결된 엔드포인트 참조를 모두 반환합니다.

형식:	String
별칭:	RT
허용되는 값:	object, epr, objectandepr
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SelectorSet

특정 관리 리소스 인스턴스를 선택하는 데 사용되는 값 쌍 집합을 지정합니다. SelectorSet 매개 변수는 둘 이상의 리소스 인스턴스가 있을 때 사용됩니다. SelectorSet 매개 변수의 값은 해시 테이블이어야 합니다.

다음 예제에서는 이 매개 변수의 값을 입력하는 방법을 보여줍니다.

-SelectorSet @{Name="WinRM";ID="yyy"}

형식:	Hashtable
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SessionOption

WS-Management 세션에 대한 확장 옵션을 지정합니다. New-WSManSessionOption cmdlet을 사용하여 만든 SessionOption 개체를 입력합니다. 사용할 수 있는 옵션에 대한 자세한 내용은 Get-Help New-WSManSessionOption입력합니다.

형식:	SessionOption
별칭:	SO
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Shallow

이 cmdlet은 리소스 URI에 지정된 기본 클래스의 인스턴스만 반환한다는 것을 나타냅니다. 이 매개 변수를 지정하지 않으면 이 cmdlet은 URI 및 모든 파생 클래스에 지정된 기본 클래스의 인스턴스를 반환합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UseSSL

SSL(Secure Sockets Layer) 프로토콜을 사용하여 원격 컴퓨터에 대한 연결을 설정하도록 지정합니다. 기본적으로 SSL은 사용되지 않습니다.

WS-Management 네트워크를 통해 전송되는 모든 Windows PowerShell 콘텐츠를 암호화합니다. UseSSL 매개 변수를 사용하면 HTTP 대신 HTTPS의 추가 보호를 지정할 수 있습니다. 연결에 사용되는 포트에서 SSL을 사용할 수 없는 경우 이 매개 변수를 지정하면 명령이 실패합니다.

형식:	SwitchParameter
별칭:	SSL
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

None

이 명령은 입력을 허용하지 않습니다.

출력

XmlElement

이 cmdlet은 XMLElement 개체를 생성합니다.

관련 링크

• Connect-WSMan
• Disable-WSManCredSSP
• Disconnect-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption
• Remove-WSManInstance
• Set-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan