Get-WSManInstance

Referensi

Modul:: Microsoft.WSMan.Management

Menampilkan informasi manajemen untuk instans sumber daya yang ditentukan oleh URI Sumber Daya.

Sintaks

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>]

Deskripsi

Get-WSManInstance Cmdlet mengambil instans sumber daya manajemen yang ditentukan oleh Pengidentifikasi Sumber Daya Seragam (URI) sumber daya. Informasi yang diambil dapat berupa kumpulan informasi XML yang kompleks, yang merupakan objek, atau nilai sederhana. Cmdlet ini setara dengan perintah Get Web Services for Management (WS-Management) standar.

Cmdlet ini menggunakan lapisan koneksi/transportasi WS-Management untuk mengambil informasi.

Contoh

Contoh 1: Mendapatkan semua informasi dari WMI

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

Perintah ini mengembalikan semua informasi yang diekspos Windows Management Instrumentation (WMI) tentang layanan WinRM di komputer server01 jarak jauh.

Contoh 2: Dapatkan status layanan Spooler

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

Perintah ini hanya mengembalikan status layanan Spooler pada komputer server01 jarak jauh.

Contoh 3: Mendapatkan referensi titik akhir untuk semua layanan

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

Perintah ini mengembalikan referensi titik akhir yang sesuai dengan semua layanan di komputer lokal.

Contoh 4: Mendapatkan layanan yang memenuhi kriteria yang ditentukan

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

Perintah ini mencantumkan semua layanan yang memenuhi kriteria berikut pada komputer Server01 jarak jauh:

Jenis startup layanan adalah Otomatis.
Layanan dihentikan.

Contoh 5: Dapatkan konfigurasi pendengar yang cocok dengan kriteria di komputer lokal

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

Perintah ini mencantumkan konfigurasi pendengar WS-Management di komputer lokal untuk pendengar yang cocok dengan kriteria dalam set pemilih.

Contoh 6: Mendapatkan konfigurasi pendengar yang cocok dengan kriteria di komputer jarak jauh

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

Perintah ini mencantumkan konfigurasi pendengar WS-Management di komputer server01 jarak jauh untuk pendengar yang cocok dengan kriteria dalam set pemilih.

Contoh 7: Mendapatkan instans terkait yang terkait dengan instans tertentu

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

Perintah ini mendapatkan instans terkait yang terkait dengan instans yang ditentukan (winrm).

Anda harus mengapit filter dalam tanda kutip, seperti yang ditunjukkan dalam contoh.

Contoh 8: Mendapatkan instans asosiasi yang terkait dengan instans tertentu

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

Perintah ini mendapatkan instans asosiasi yang terkait dengan instans yang ditentukan (winrm). Karena nilai Dialek adalah asosiasi dan parameter Asosiasi digunakan, perintah ini mengembalikan instans asosiasi, bukan instans terkait.

Anda harus mengapit filter dalam tanda kutip, seperti yang ditunjukkan dalam contoh.

Parameter

-ApplicationName

Menentukan nama aplikasi dalam koneksi. Nilai default parameter ApplicationName adalah WSMAN. Pengidentifikasi lengkap untuk titik akhir jarak jauh dalam format berikut:

Misalnya: http://server01:8080/WSMAN

Layanan Informasi Internet (IIS), yang menghosting sesi, meneruskan permintaan dengan titik akhir ini ke aplikasi yang ditentukan. Pengaturan default WSMAN ini sesuai untuk sebagian besar penggunaan. Parameter ini dirancang untuk digunakan jika banyak komputer membuat koneksi jarak jauh ke satu komputer yang menjalankan PowerShell. Dalam hal ini, IIS menghosting WS-Management untuk efisiensi.

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

-Associations

Menunjukkan bahwa cmdlet ini mendapatkan instans asosiasi, bukan instans terkait. Anda hanya dapat menggunakan parameter ini saat parameter Dialect memiliki nilai Asosiasi.

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

-Authentication

Menentukan mekanisme autentikasi yang akan digunakan di server. Nilai yang dapat diterima untuk parameter ini adalah:

Basic - Dasar adalah skema di mana nama pengguna dan kata sandi dikirim dalam teks yang jelas ke server atau proksi.
Default - Gunakan metode autentikasi yang diterapkan oleh protokol WS-Management. Ini adalah default.
Digest - Digest adalah skema respons tantangan yang menggunakan string data yang ditentukan server untuk tantangan tersebut.
Kerberos - Komputer klien dan server saling mengautentikasi dengan menggunakan sertifikat Kerberos.
Negotiate - Bernegosiasi adalah skema respons tantangan yang bernegosiasi dengan server atau proksi untuk menentukan skema yang akan digunakan untuk autentikasi. Misalnya, nilai parameter ini memungkinkan negosiasi untuk menentukan apakah protokol Kerberos atau NTLM digunakan.
CredSSP - Gunakan autentikasi Penyedia Dukungan Keamanan Kredensial (CredSSP), yang memungkinkan pengguna mendelegasikan kredensial. Opsi ini dirancang untuk perintah yang berjalan di satu komputer jarak jauh tetapi mengumpulkan data dari atau menjalankan perintah tambahan di komputer jarak jauh lainnya.

Perhatian

CredSSP mendelegasikan kredensial pengguna dari komputer lokal ke komputer jarak jauh. Praktik ini meningkatkan risiko keamanan operasi jarak jauh. Jika komputer jarak jauh disusupi, ketika kredensial diteruskan ke komputer jarak jauh, kredensial dapat digunakan untuk mengontrol sesi jaringan.

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

Menunjukkan bahwa cmdlet ini hanya menghitung properti yang merupakan bagian dari kelas dasar yang ditentukan oleh parameter ResourceURI . Parameter ini tidak berpengaruh jika parameter Shallow ditentukan.

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

-CertificateThumbprint

Menentukan sertifikat kunci publik digital (X509) dari akun pengguna yang memiliki izin untuk melakukan tindakan ini. Masukkan thumbprint sertifikat sertifikat.

Sertifikat digunakan dalam autentikasi berbasis sertifikat klien. Mereka hanya dapat dipetakan ke akun pengguna lokal; mereka tidak bekerja dengan akun domain.

Untuk mendapatkan thumbprint sertifikat, gunakan Get-Item perintah atau Get-ChildItem di drive PowerShell Cert: .

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

-ComputerName

Menentukan komputer yang akan menjalankan operasi manajemen. Nilainya dapat berupa nama domain yang sepenuhnya memenuhi syarat, nama NetBIOS, atau alamat IP. Gunakan nama komputer lokal, gunakan localhost, atau gunakan titik (.) untuk menentukan komputer lokal. Komputer lokal adalah default. Ketika komputer jarak jauh berada di domain yang berbeda dari pengguna, Anda harus menggunakan nama domain yang sepenuhnya memenuhi syarat harus digunakan. Anda dapat menyalurkan nilai untuk parameter ini ke cmdlet.

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

-ConnectionURI

Menentukan titik akhir koneksi. Format string ini adalah sebagai berikut:

String berikut adalah nilai yang diformat dengan benar untuk parameter ini:

http://Server01:8080/WSMAN

URI harus sepenuhnya memenuhi syarat.

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

-Credential

Menentukan akun pengguna yang memiliki izin untuk melakukan tindakan ini. Defaultnya adalah pengguna saat ini. Ketik nama pengguna, seperti User01, Domain01\User01, atau User@Domain.com. Atau, masukkan objek PSCredential , seperti objek yang dikembalikan oleh Get-Credential cmdlet. Saat Anda mengetik nama pengguna, cmdlet ini meminta kata sandi kepada Anda.

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

-Dialect

Menentukan dialek yang akan digunakan dalam predikat filter. Ini bisa menjadi dialek apa pun yang didukung oleh layanan jarak jauh. Alias berikut dapat digunakan untuk URI dialek:

WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
Pemilih- http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
Asosiasi- 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

Menunjukkan bahwa cmdlet ini mengembalikan semua instans sumber daya manajemen.

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

-Filter

Menentukan ekspresi filter untuk enumerasi. Jika Anda menentukan parameter ini, Anda juga harus menentukan Dialect.

Nilai yang valid dari parameter ini bergantung pada dialek yang ditentukan dalam Dialek. Misalnya, jika Dialect adalah WQL, parameter Filter harus berisi string, dan string harus berisi kueri WQL yang valid seperti kueri berikut:

"Select * from Win32_Service where State != Running"

Jika Dialect adalah Asosiasi, Filter harus berisi string, dan string harus berisi filter yang valid, seperti filter berikut:

-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

Menentukan bagian di dalam instans yang akan diperbarui atau diambil untuk operasi yang ditentukan. Misalnya, untuk mendapatkan status layanan penampung, tentukan hal berikut:

-Fragment Status

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

-OptionSet

Menentukan sekumpulan sakelar ke layanan untuk memodifikasi atau memperbaiki sifat permintaan. Sakelar menyerupai ini digunakan dalam shell baris perintah karena spesifik untuk layanan. Sejumlah opsi dapat ditentukan.

Contoh berikut menunjukkan sintaks yang meneruskan nilai 1, 2, dan 3 untuk parameter a, b, dan c:

-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

Menentukan port yang akan digunakan ketika klien tersambung ke layanan WinRM. Ketika transportasi adalah HTTP, port default adalah 80. Ketika transportasi adalah HTTPS, port default adalah 443.

Saat Anda menggunakan HTTPS sebagai transportasi, nilai parameter ComputerName harus cocok dengan nama umum sertifikat (CN) server. Namun, jika parameter SkipCNCheck ditentukan sebagai bagian dari parameter SessionOption , nama umum sertifikat server tidak harus cocok dengan nama host server. Parameter SkipCNCheck harus digunakan hanya untuk komputer tepercaya.

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

-ResourceURI

Menentukan URI kelas atau instans sumber daya. URI mengidentifikasi jenis sumber daya tertentu, seperti disk atau proses, di komputer.

URI terdiri dari awalan dan jalur sumber daya. Contohnya:

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

Menentukan jenis data yang akan dikembalikan. Nilai yang dapat diterima untuk parameter ini adalah:

Object
EPR
ObjectAndEPR

Nilai defaultnya adalah Object.

Jika Anda menentukan Object atau tidak menentukan parameter ini, cmdlet ini hanya mengembalikan objek. Jika Anda menentukan referensi titik akhir (EPR) cmdlet ini hanya mengembalikan referensi titik akhir objek. Referensi titik akhir berisi informasi tentang URI sumber daya dan pemilih untuk instans. Jika Anda menentukan ObjectAndEPR, cmdlet ini mengembalikan objek dan referensi titik akhir terkait.

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

Menentukan sekumpulan pasangan nilai yang digunakan untuk memilih instans sumber daya manajemen tertentu. Parameter SelectorSet digunakan ketika ada lebih dari satu instans sumber daya. Nilai parameter SelectorSet harus berupa tabel hash.

Contoh berikut menunjukkan cara memasukkan nilai untuk parameter ini:

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

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

-SessionOption

Menentukan opsi yang diperluas untuk sesi WS-Management. Masukkan objek SessionOption yang Anda buat dengan menggunakan cmdlet New-WSManSessionOption. Untuk informasi selengkapnya tentang opsi yang tersedia, ketik Get-Help New-WSManSessionOption.

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

-Shallow

Menunjukkan bahwa cmdlet ini hanya mengembalikan instans kelas dasar yang ditentukan dalam URI sumber daya. Jika Anda tidak menentukan parameter ini, cmdlet ini mengembalikan instans kelas dasar yang ditentukan dalam URI dan di semua kelas turunannya.

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

-UseSSL

Menentukan bahwa protokol Secure Sockets Layer (SSL) digunakan untuk membuat koneksi ke komputer jarak jauh. Secara default, SSL tidak digunakan.

WS-Management mengenkripsi semua konten Windows PowerShell yang dikirimkan melalui jaringan. Parameter UseSSL memungkinkan Anda menentukan perlindungan tambahan HTTPS alih-alih HTTP. Jika SSL tidak tersedia pada port yang digunakan untuk koneksi, dan Anda menentukan parameter ini, perintah gagal.

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

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

XmlElement

Cmdlet ini mengembalikan objek XMLElement .

Get-WSManInstance

Sintaks

Deskripsi

Contoh

Contoh 1: Mendapatkan semua informasi dari WMI

Contoh 2: Dapatkan status layanan Spooler

Contoh 3: Mendapatkan referensi titik akhir untuk semua layanan

Contoh 4: Mendapatkan layanan yang memenuhi kriteria yang ditentukan

Contoh 5: Dapatkan konfigurasi pendengar yang cocok dengan kriteria di komputer lokal

Contoh 6: Mendapatkan konfigurasi pendengar yang cocok dengan kriteria di komputer jarak jauh

Contoh 7: Mendapatkan instans terkait yang terkait dengan instans tertentu

Contoh 8: Mendapatkan instans asosiasi yang terkait dengan instans tertentu

Parameter

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Input

Output

Saran dan Komentar

Sumber Daya Tambahan:

Get-WSManInstance

Sintaks

Deskripsi

Contoh

Contoh 1: Mendapatkan semua informasi dari WMI

Contoh 2: Dapatkan status layanan Spooler

Contoh 3: Mendapatkan referensi titik akhir untuk semua layanan

Contoh 4: Mendapatkan layanan yang memenuhi kriteria yang ditentukan

Contoh 5: Dapatkan konfigurasi pendengar yang cocok dengan kriteria di komputer lokal

Contoh 6: Mendapatkan konfigurasi pendengar yang cocok dengan kriteria di komputer jarak jauh

Contoh 7: Mendapatkan instans terkait yang terkait dengan instans tertentu

Contoh 8: Mendapatkan instans asosiasi yang terkait dengan instans tertentu

Parameter

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Input

Output

Link Terkait

Saran dan Komentar

Sumber Daya Tambahan: