共用方式為


Get-WSManInstance

顯示資源 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) 所指定的管理資源的實例。 擷取的資訊可以是複雜的 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

此命令會傳回 Windows Management Instrumentation (WMI) 在遠端 server01 電腦上公開 WinRM 服務的所有資訊。

範例 2:取得多任務緩衝處理程式服務的狀態

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

此命令只會傳回遠端 server01 電腦上 多任務緩衝處理程式 服務的狀態。

範例 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 電腦上符合下列準則的所有服務:

  • 服務的啟動類型為 Automatic。
  • 服務已停止。

範例 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) 相關的關聯實例。 因為 方言 值是關聯,而且使用 關聯 參數,此命令會傳回關聯實例,而不是相關聯的實例。

您必須以引弧括住篩選條件,如範例所示。

參數

-ApplicationName

指定連接中的應用程式名稱。 ApplicationName 參數的預設值為 WSMAN。 遠端端端點的完整識別碼格式如下:

<傳輸>://<伺服器>:<埠>/<ApplicationName>

例如:http://server01:8080/WSMAN

裝載會話的 Internet Information Services (IIS)會將具有此端點的要求轉送至指定的應用程式。 此 WSMAN 的預設設定適用於大部分用途。 如果許多電腦與一部執行 PowerShell 的電腦建立遠端連線,則此參數的設計用途為 。 在此情況下,IIS 主機 WS-Management 效率。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Associations

表示這個 Cmdlet 會取得關聯實例,而不是相關聯的實例。 只有當 方言 參數具有 Association 值時,才可以使用此參數。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Authentication

指定要在伺服器上使用的驗證機制。 此參數可接受的值為:

  • 基本。 基本是一種配置,其中使用者名稱和密碼會以純文本傳送至伺服器或 Proxy。
  • 違約。 使用由 WS-Management 通訊協議實作的驗證方法。 這是預設值。
  • 消化。 摘要是一種挑戰回應配置,使用伺服器指定的數據字串來進行挑戰。
  • Kerberos。 用戶端計算機和伺服器會使用 Kerberos 憑證相互驗證。
  • 談判。 Negotiate 是一種挑戰回應配置,會與伺服器或 Proxy 交涉,以判斷要用於驗證的配置。 例如,此參數值允許交涉來判斷是否使用 Kerberos 通訊協定或 NTLM。
  • CredSSP。 使用認證安全性支援提供者 (CredSSP) 驗證,讓使用者委派認證。 此選項是針對在一部遠端電腦上執行的命令所設計,但從其他遠端電腦上收集資料或執行其他命令。

注意:CredSSP 會將使用者認證從本機計算機委派給遠端計算機。 這種做法會增加遠端作業的安全性風險。 如果遠端電腦遭到入侵,當認證傳遞至該計算機時,可以使用認證來控制網路會話。

類型:AuthenticationMechanism
別名:auth, am
接受的值:None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-BasePropertiesOnly

指出這個 Cmdlet 只會列舉由 ResourceURI 參數所指定基類的一部分屬性。 如果指定了 淺層 參數,此參數就不會有任何作用。

類型:SwitchParameter
別名:UBPO, Base
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CertificateThumbprint

指定具有執行此動作許可權之用戶帳戶的數位公鑰憑證 (X509)。 輸入憑證的憑證指紋。

憑證用於客戶端憑證型驗證。 它們只能對應至本機用戶帳戶;它們不適用於網域帳戶。

若要取得憑證指紋,請使用PowerShell憑證: 磁碟驅動器中的 Get-Item 或 Get-ChildItem 命令。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ComputerName

指定要執行管理作業的電腦。 此值可以是完整功能變數名稱、NetBIOS 名稱或IP位址。 使用本機計算機名稱、使用localhost,或使用點 (.) 來指定本機電腦。 本機計算機是預設值。 當遠端電腦位於與使用者不同的網域時,您必須使用完整功能變數名稱。 您可以使用管線將此參數的值傳送至 Cmdlet。

類型:String
別名:CN
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ConnectionURI

指定連接端點。 此字串格式如下所示:

<傳輸>://<Server>:<埠>/<ApplicationName>

下列字串是此參數正確格式化的值:

http://Server01:8080/WSMAN

URI 必須完整。

類型:Uri
別名:CURI, CU
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Credential

指定具有執行此動作許可權的用戶帳戶。 預設值為目前的使用者。 輸入使用者名稱,例如 User01、Domain01\User01 或 User@Domain.com。 或者,輸入 PSCredential 物件,例如 Get-Credential Cmdlet 所傳回的物件。 當您輸入使用者名稱時,此 Cmdlet 會提示您輸入密碼。

類型:PSCredential
別名:cred, c
Position:Named
預設值: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
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Enumerate

表示此 Cmdlet 會傳回管理資源的所有實例。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Filter

指定列舉的篩選表達式。 如果您指定此參數,也必須指定 Dialect

此參數的有效值取決於 Dialect中指定的方言。 例如,如果 方言 為 WQL,Filter 參數必須包含字串,而且字串必須包含有效的 WQL 查詢,例如下列查詢:

"Select * from Win32_Service where State != Running"

如果 方言 為關聯,Filter 必須包含字串,而且字串必須包含有效的篩選條件,例如下列篩選條件:

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

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Fragment

指定要針對指定作業更新或擷取實例內的區段。 例如,若要取得多任務緩衝處理程式服務的狀態,請指定下列專案:

-Fragment Status

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-OptionSet

指定一組切換至服務,以修改或精簡要求的性質。 這些參數類似於命令行殼層中使用的參數,因為它們是特定的服務。 您可以指定任意數目的選項。

下列範例示範傳遞 a、b 和 c 參數值 1、2 和 3 的語法:

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

類型:Hashtable
別名:OS
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Port

指定客戶端連線到 WinRM 服務時要使用的埠。 當傳輸為 HTTP 時,預設埠為 80。 當傳輸是 HTTPS 時,預設埠為 443。

當您使用 HTTPS 做為傳輸時,ComputerName 參數的值必須符合伺服器的憑證一般名稱 (CN)。 不過,如果 SkipCNCheck 參數指定為 SessionOption 參數的一部分,則伺服器的憑證一般名稱不需要符合伺服器的主機名。 SkipCNCheck 參數應該只用於信任的計算機。

類型:Int32
Position:Named
預設值: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
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ReturnType

指定要傳回的數據類型。 此參數可接受的值為:

  • 物件
  • EPR
  • ObjectAndEPR

預設值為 Object。

如果您指定 Object 或未指定此參數,則此 Cmdlet 只會傳回 物件。 如果您指定端點參考 (EPR),此 Cmdlet 只會傳回 物件的端點參考。 端點參考包含資源 URI 和實例選取器的相關信息。 如果您指定 ObjectAndEPR,這個 Cmdlet 會同時傳回物件及其相關聯的端點參考。

類型:String
別名:RT
接受的值:object, epr, objectandepr
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SelectorSet

指定一組值組,用來選取特定的管理資源實例。 當資源有多個實例存在時,會使用 SelectorSet 參數。 SelectorSet 參數的值必須是哈希表。

下列範例示範如何輸入此參數的值:

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

類型:Hashtable
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SessionOption

指定 WS-Management 工作階段的擴充選項。 輸入您使用 New-WSManSessionOption Cmdlet 建立的 SessionOption 物件。 如您可以可用選項的詳細資訊,請輸入 Get-Help New-WSManSessionOption

類型:SessionOption
別名:SO
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Shallow

表示此 Cmdlet 只會傳回資源 URI 中指定的基類實例。 如果您未指定此參數,這個 Cmdlet 會傳回 URI 和其所有衍生類別中指定的基類實例。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UseSSL

指定使用安全套接字層 (SSL) 通訊協定來建立遠端電腦的連線。 根據預設,不會使用 SSL。

WS-Management 會加密透過網路傳輸的所有 Windows PowerShell 內容。 UseSSL 參數可讓您指定 HTTPS 的額外保護,而不是 HTTP。 如果連線所使用的埠上無法使用 SSL,而且您指定此參數,則命令會失敗。

類型:SwitchParameter
別名:SSL
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

None

此命令不接受任何輸入。

輸出

XmlElement

此 Cmdlet 會產生 XMLElement 物件。