Get-WSManInstance

Başvuru

Modül:: Microsoft.WSMan.Management

Kaynak URI'si tarafından belirtilen bir kaynak örneğinin yönetim bilgilerini görüntüler.

Syntax

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

Cmdlet, Get-WSManInstance bir kaynak Tekdüzen Kaynak Tanımlayıcısı (URI) tarafından belirtilen bir yönetim kaynağının örneğini alır. Alınan bilgiler, nesne olan karmaşık bir XML bilgi kümesi veya basit bir değer olabilir. Bu cmdlet, standart Yönetim için Web Hizmetleri (WS-Management) Get komutuyla eşdeğerdir.

Bu cmdlet, bilgileri almak için WS-Management bağlantı/aktarım katmanını kullanır.

Örnekler

Örnek 1: WMI'dan tüm bilgileri alma

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="winrm"} -ComputerName "Server01"

Bu komut, Windows Yönetim Araçları'nın (WMI) uzak sunucu01 bilgisayardaki WinRM hizmeti hakkında kullanıma sunulan tüm bilgileri döndürür.

Örnek 2: Biriktirici hizmetinin durumunu alma

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="spooler"} -Fragment Status -ComputerName "Server01"

Bu komut yalnızca uzak sunucu01 bilgisayardaki Biriktirici hizmetinin durumunu döndürür.

Örnek 3: Tüm hizmetler için uç nokta başvuruları alma

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/win32_service -ReturnType EPR

Bu komut, yerel bilgisayardaki tüm hizmetlere karşılık gelen uç nokta başvurularını döndürür.

Örnek 4: Belirtilen ölçütlere uyan hizmetleri alma

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/* -Filter "select * from win32_service where StartMode = 'Auto' and State = 'Stopped'" -ComputerName "Server01"

Bu komut, uzak Server01 bilgisayarında aşağıdaki ölçütlere uyan tüm hizmetleri listeler:

Hizmetin başlangıç türü Otomatik'tir.
Hizmet durduruldu.

Örnek 5: Yerel bilgisayardaki ölçütlere uyan dinleyici yapılandırmasını alma

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"}

Bu komut, yerel bilgisayarda seçici kümesindeki ölçütlerle eşleşen dinleyici için WS-Management dinleyici yapılandırmasını listeler.

Örnek 6: Uzak bilgisayardaki ölçütlere uyan dinleyici yapılandırmasını alma

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"} -ComputerName "Server01"

Bu komut, seçici kümesindeki ölçütlerle eşleşen dinleyici için uzak sunucu01 bilgisayarında WS-Management dinleyici yapılandırmasını listeler.

Örnek 7: Belirtilen örnekle ilgili ilişkili örnekleri alma

Get-WSManInstance -Enumerate -Dialect Association -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

Bu komut, belirtilen örnekle (winrm) ilgili ilişkili örnekleri alır.

Örnekte gösterildiği gibi filtreyi tırnak içine almanız gerekir.

Örnek 8: Belirtilen örnekle ilgili ilişkilendirme örneklerini alma

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

Bu komut, belirtilen örnekle (winrm) ilgili ilişkilendirme örneklerini alır. Diyalekt değeri ilişkilendirme olduğundan ve Associations parametresi kullanıldığından, bu komut ilişkili örnekleri değil ilişkilendirme örneklerini döndürür.

Örnekte gösterildiği gibi filtreyi tırnak içine almanız gerekir.

Parametreler

-ApplicationName

Bağlantıdaki uygulama adını belirtir. ApplicationName parametresinin varsayılan değeri WSMAN'dır. Uzak uç noktanın tam tanımlayıcısı aşağıdaki biçimdedir:

Örneğin: http://server01:8080/WSMAN

Oturumu barındıran Internet Information Services (IIS), bu uç nokta ile istekleri belirtilen uygulamaya iletir. WSMAN'ın bu varsayılan ayarı çoğu kullanım için uygundur. Bu parametre, birçok bilgisayar PowerShell çalıştıran bir bilgisayara uzak bağlantılar kurarsa kullanılacak şekilde tasarlanmıştır. Bu durumda IIS, verimlilik için WS-Management'ı barındırıyor.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Associations

Bu cmdlet'in ilişkili örnekleri değil ilişkilendirme örneklerini aldığını gösterir. Bu parametreyi yalnızca Diyalekt parametresi İlişkilendirme değerine sahip olduğunda kullanabilirsiniz.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Authentication

Sunucuda kullanılacak kimlik doğrulama mekanizmasını belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

Basic - Temel, kullanıcı adı ve parolanın sunucuya veya ara sunucuya düz metin olarak gönderildiği bir düzendir.
Default - WS-Management protokolü tarafından uygulanan kimlik doğrulama yöntemini kullanın. Bu varsayılan seçenektir.
Digest - Özet, sınama için sunucu tarafından belirtilen bir veri dizesi kullanan bir sınama yanıtı düzenidir.
Kerberos - İstemci bilgisayar ve sunucu, Kerberos sertifikalarını kullanarak karşılıklı olarak kimlik doğrulaması yapar.
Negotiate - Anlaşma, kimlik doğrulaması için kullanılacak düzeni belirlemek üzere sunucu veya ara sunucuyla anlaşma sağlayan bir sınama yanıtı şemasıdır. Örneğin, bu parametre değeri, anlaşmanın Kerberos protokolü mü yoksa NTLM mi kullanıldığını belirlemesine olanak tanır.
CredSSP - Kullanıcının kimlik bilgilerini temsilci olarak atamasına olanak tanıyan Kimlik Bilgisi Güvenlik Desteği Sağlayıcısı (CredSSP) kimlik doğrulamasını kullanın. Bu seçenek, bir uzak bilgisayarda çalışan ancak diğer uzak bilgisayarlardan veri toplayan veya başka komutlar çalıştıran komutlar için tasarlanmıştır.

Dikkat

CredSSP, kullanıcı kimlik bilgilerini yerel bilgisayardan uzak bir bilgisayara devreder. Bu uygulama, uzak işlemin güvenlik riskini artırır. Uzak bilgisayarın güvenliği aşılırsa, kimlik bilgileri ona geçirildiğinde, kimlik bilgileri ağ oturumunu denetlemek için kullanılabilir.

Type:	AuthenticationMechanism
Aliases:	auth, am
Accepted values:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BasePropertiesOnly

Bu cmdlet'in yalnızca ResourceURI parametresi tarafından belirtilen temel sınıfın parçası olan özellikleri numaralandırdığını gösterir. Shallow parametresi belirtilirse bu parametrenin hiçbir etkisi olmaz.

Type:	SwitchParameter
Aliases:	UBPO, Base
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Bu eylemi gerçekleştirme izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X509) belirtir. Sertifikanın sertifika parmak izini girin.

Sertifikalar, istemci sertifikası tabanlı kimlik doğrulamasında kullanılır. Bunlar yalnızca yerel kullanıcı hesaplarıyla eşlenebilir; etki alanı hesaplarıyla çalışmaz.

Sertifika parmak izi almak için PowerShell Cert: sürücüsündeki veya Get-ChildItem komutunu kullanınGet-Item.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

Yönetim işleminin çalıştırıldığı bilgisayarı belirtir. Değer tam etki alanı adı, NetBIOS adı veya IP adresi olabilir. Yerel bilgisayar adını kullanın, localhost kullanın veya yerel bilgisayarı belirtmek için nokta (.) kullanın. Yerel bilgisayar varsayılandır. Uzak bilgisayar kullanıcıdan farklı bir etki alanında olduğunda, tam etki alanı adı kullanmanız gerekir. Bu parametre için bir değeri cmdlet'ine yöneltebilirsiniz.

Type:	String
Aliases:	CN
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionURI

Bağlantı uç noktasını belirtir. Bu dizenin biçimi aşağıdaki gibidir:

Aşağıdaki dize, bu parametre için doğru biçimlendirilmiş bir değerdir:

http://Server01:8080/WSMAN

URI tam olarak nitelenmiş olmalıdır.

Type:	Uri
Aliases:	CURI, CU
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır. User01, Domain01\User01 veya User@Domain.comgibi bir kullanıcı adı yazın. Alternatif olarak, cmdlet'i tarafından Get-Credential döndürülen nesne gibi bir PSCredential nesnesi de girin. Bir kullanıcı adı yazdığınızda, bu cmdlet sizden parola ister.

Type:	PSCredential
Aliases:	cred, c
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Dialect

Filtre koşulunda kullanılacak diyalekt belirtir. Bu, uzak hizmet tarafından desteklenen herhangi bir diyalekt olabilir. Diyalekt URI'sinde aşağıdaki diğer adlar kullanılabilir:

WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
Seçici- http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
Derneği- http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Enumerate

Bu cmdlet'in bir yönetim kaynağının tüm örneklerini döndürdüğünü gösterir.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

Numaralandırma için filtre ifadesini belirtir. Bu parametreyi belirtirseniz Diyalekt de belirtmeniz gerekir.

Bu parametrenin geçerli değerleri, Diyalekt'te belirtilen diyalekt değerine bağlıdır. Örneğin, Dialect WQL ise Filter parametresi bir dize içermeli ve dize aşağıdaki sorgu gibi geçerli bir WQL sorgusu içermelidir:

"Select * from Win32_Service where State != Running"

Diyalekt İlişkilendirme ise, Filtre bir dize içermeli ve dize aşağıdaki filtre gibi geçerli bir filtre içermelidir:

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Fragment

Örneğin içinde, belirtilen işlem için güncelleştirilecek veya alınacak bir bölüm belirtir. Örneğin, bir biriktirici hizmetinin durumunu almak için aşağıdakileri belirtin:

-Fragment Status

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OptionSet

İsteğin niteliğini değiştirmek veya iyileştirmek için bir hizmete geçiş kümesi belirtir. Bunlar hizmete özgü olduklarından komut satırı kabuklarında kullanılan anahtarlara benzer. Herhangi bir sayıda seçenek belirtilebilir.

Aşağıdaki örnek, a, b ve c parametreleri için 1, 2 ve 3 değerlerini geçiren söz dizimini gösterir:

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

Type:	Hashtable
Aliases:	OS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Port

İstemci WinRM hizmetine bağlandığında kullanılacak bağlantı noktasını belirtir. Aktarım HTTP olduğunda varsayılan bağlantı noktası 80'dir. Aktarım HTTPS olduğunda varsayılan bağlantı noktası 443'dür.

Aktarım olarak HTTPS kullandığınızda, ComputerName parametresinin değeri sunucunun sertifika ortak adıyla (CN) eşleşmelidir. Ancak, SkipCNCheck parametresi SessionOption parametresinin bir parçası olarak belirtilirse, sunucunun sertifika ortak adının sunucunun ana bilgisayar adıyla eşleşmesi gerekmez. SkipCNCheck parametresi yalnızca güvenilen bilgisayarlar için kullanılmalıdır.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceURI

Kaynak sınıfının veya örneğin URI'sini belirtir. URI, bir bilgisayardaki diskler veya işlemler gibi belirli bir kaynak türünü tanımlar.

URI bir ön ek ve kaynağın yolundan oluşur. Örneğin:

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

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

Type:	Uri
Aliases:	RURI
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReturnType

Döndürülecek veri türünü belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

Object
EPR
ObjectAndEPR

Varsayılan değer şudur: Object.

Bu parametreyi belirtir Object veya belirtmezseniz, bu cmdlet yalnızca nesneleri döndürür. Uç nokta başvurusu (EPR) belirtirseniz bu cmdlet yalnızca nesnelerin uç nokta başvurularını döndürür. Uç nokta başvuruları, kaynak URI'si ve örneğin seçicileri hakkında bilgi içerir. belirtirseniz ObjectAndEPR, bu cmdlet hem nesnesini hem de ilişkili uç nokta başvurularını döndürür.

Type:	String
Aliases:	RT
Accepted values:	object, epr, objectandepr
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SelectorSet

Belirli yönetim kaynağı örneklerini seçmek için kullanılan değer çiftleri kümesini belirtir. SelectorSet parametresi, kaynağın birden fazla örneği mevcut olduğunda kullanılır. SelectorSet parametresinin değeri bir karma tablo olmalıdır.

Aşağıdaki örnekte bu parametre için bir değerin nasıl girilir gösterilmektedir:

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

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SessionOption

WS-Management oturumu için genişletilmiş seçenekleri belirtir. New-WSManSessionOption cmdlet'ini kullanarak oluşturduğunuz bir SessionOption nesnesi girin. Kullanılabilir seçenekler hakkında daha fazla bilgi için yazın Get-Help New-WSManSessionOption.

Type:	SessionOption
Aliases:	SO
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Shallow

Bu cmdlet'in yalnızca kaynak URI'sinde belirtilen temel sınıfın örneklerini döndürdüğünü gösterir. Bu parametreyi belirtmezseniz, bu cmdlet URI'de ve türetilmiş tüm sınıflarında belirtilen temel sınıfın örneklerini döndürür.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSSL

Uzak bilgisayara bağlantı kurmak için Güvenli Yuva Katmanı (SSL) protokolunun kullanıldığını belirtir. Varsayılan olarak SSL kullanılmaz.

WS-Management, ağ üzerinden iletilen tüm Windows PowerShell içeriğini şifreler. UseSSL parametresi, HTTP yerine HTTPS'nin ek korumasını belirtmenize olanak tanır. Bağlantı için kullanılan bağlantı noktasında SSL kullanılamıyorsa ve bu parametreyi belirtirseniz, komut başarısız olur.

Type:	SwitchParameter
Aliases:	SSL
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

XmlElement

Bu cmdlet bir XMLElement nesnesi döndürür.

Aracılığıyla paylaş

Get-WSManInstance

Syntax

Description

Örnekler

Örnek 1: WMI'dan tüm bilgileri alma

Örnek 2: Biriktirici hizmetinin durumunu alma

Örnek 3: Tüm hizmetler için uç nokta başvuruları alma

Örnek 4: Belirtilen ölçütlere uyan hizmetleri alma

Örnek 5: Yerel bilgisayardaki ölçütlere uyan dinleyici yapılandırmasını alma

Örnek 6: Uzak bilgisayardaki ölçütlere uyan dinleyici yapılandırmasını alma

Örnek 7: Belirtilen örnekle ilgili ilişkili örnekleri alma

Örnek 8: Belirtilen örnekle ilgili ilişkilendirme örneklerini alma

Parametreler

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Girişler

Çıkışlar

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

Get-WSManInstance

Syntax

Description

Örnekler

Örnek 1: WMI'dan tüm bilgileri alma

Örnek 2: Biriktirici hizmetinin durumunu alma

Örnek 3: Tüm hizmetler için uç nokta başvuruları alma

Örnek 4: Belirtilen ölçütlere uyan hizmetleri alma

Örnek 5: Yerel bilgisayardaki ölçütlere uyan dinleyici yapılandırmasını alma

Örnek 6: Uzak bilgisayardaki ölçütlere uyan dinleyici yapılandırmasını alma

Örnek 7: Belirtilen örnekle ilgili ilişkili örnekleri alma

Örnek 8: Belirtilen örnekle ilgili ilişkilendirme örneklerini alma

Parametreler

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Girişler

Çıkışlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar