Set-WSManInstance

Modul:

Microsoft.WSMan.Management Module

Memodifikasi informasi manajemen yang terkait dengan sumber daya.

Sintaks

ComputerName (Default)

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

URI

Set-WSManInstance
    [-ResourceURI] <Uri>
    [[-SelectorSet] <Hashtable>]
    [-ConnectionURI <Uri>]
    [-Dialect <Uri>]
    [-FilePath <String>]
    [-Fragment <String>]
    [-OptionSet <Hashtable>]
    [-SessionOption <SessionOption>]
    [-ValueSet <Hashtable>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Deskripsi

cmdlet Set-WSManInstance memodifikasi informasi manajemen yang terkait dengan sumber daya.

Cmdlet ini menggunakan lapisan koneksi/transportasi WinRM untuk mengubah informasi.

Contoh

Contoh 1: Menonaktifkan pendengar di komputer lokal

Set-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}

cfg                   : http://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.171, ::1, 2001:4898:0:fff:0:5efe:172.30.168.171...}

Perintah ini menonaktifkan pendengar HTTPS di komputer lokal.

Penting

Parameter ValueSet peka huruf besar/kecil saat mencocokkan properti yang ditentukan.

Misalnya, dalam perintah ini,

Ini gagal: -ValueSet @{enabled="False"}

Ini berhasil: -ValueSet @{Enabled="False"}

Contoh 2: Atur ukuran amplop maksimum di komputer lokal

Set-WSManInstance -ResourceURI winrm/config -ValueSet @{MaxEnvelopeSizekb = "200"}

cfg                 : http://schemas.microsoft.com/wbem/wsman/1/config
lang                : en-US
MaxEnvelopeSizekb   : 200
MaxTimeoutms        : 60000
MaxBatchItems       : 32000
MaxProviderRequests : 4294967295
Client              : Client
Service             : Service
Winrs               : Winrs

Perintah ini mengatur nilai MaxEnvelopeSizekb ke 200 di komputer lokal.

Penting

Parameter ValueSet peka huruf besar/kecil saat mencocokkan properti yang ditentukan.

Misalnya, menggunakan perintah di atas.

Ini gagal: -ValueSet @{MaxEnvelopeSizeKB ="200"}

Ini berhasil: -ValueSet @{MaxEnvelopeSizekb ="200"}

Contoh 3: Menonaktifkan pendengar di komputer jarak jauh

Set-WSManInstance -ResourceURI winrm/config/listener -ComputerName SERVER02 -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}

cfg                   : http://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.172, ::1, 2001:4898:0:fff:0:5efe:172.30.168.172...}

Perintah ini menonaktifkan pendengar HTTPS pada komputer jarak jauh SERVER02.

Penting

Parameter ValueSet peka huruf besar/kecil saat mencocokkan properti yang ditentukan.

Misalnya, menggunakan perintah di atas.

Ini gagal: -ValueSet @{enabled="False"}

Ini berhasil: -ValueSet @{Enabled="False"}

Parameter

-ApplicationName

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

<transport>://<server>:<port>/<ApplicationName>

Contohnya:

http://server01:8080/WSMAN

Internet Information Services (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 ketika banyak komputer membuat koneksi jarak jauh ke satu komputer yang menjalankan Windows PowerShell. Dalam hal ini, IIS menghosting Web Services for Management (WS-Management) untuk efisiensi.

Properti parameter

Jenis:	String
Nilai default:	Wsman
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Authentication

Menentukan mekanisme autentikasi yang akan digunakan di server. Nilai yang mungkin 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: Negosiasi 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 untuk 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.

Caution

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.

Properti parameter

Jenis:	AuthenticationMechanism
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	autentikasi, Am

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CertificateThumbprint

Menentukan sertifikat kunci publik digital (X509) dari akun pengguna yang memiliki izin untuk melakukan tindakan ini. Masukkan sidik jari 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 perintah Get-Item atau Get-ChildItem di drive Cert: PowerShell.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ComputerName

Menentukan komputer yang ingin Anda jalankan operasi manajemennya. Nilainya dapat berupa nama domain yang sepenuhnya memenuhi syarat, nama NetBIOS, atau alamat IP. Gunakan nama komputer lokal, localhost, atau 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. Anda dapat menyalurkan nilai untuk parameter ini ke cmdlet.

Properti parameter

Jenis:	String
Nilai default:	Localhost
Mendukung wildcard:	False
DontShow:	False
Alias:	Cina

Kumpulan parameter

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ConnectionURI

Menentukan titik akhir koneksi. Format string ini adalah:

<Transport>://<Server>:<Port>/<ApplicationName>

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

http://Server01:8080/WSMAN

URI harus berkualifikasi lengkap.

Properti parameter

Jenis:	Uri
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

URI

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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 yang dikembalikan oleh cmdlet Get-Credential. Saat Anda mengetik nama pengguna, Anda akan dimintai kata sandi.

Properti parameter

Jenis:	PSCredential
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	cred, c

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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
• Selector: http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• Association: http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Properti parameter

Jenis:	Uri
Nilai default:	http://schemas.microsoft.com/wbem/wsman/1/WQL
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-FilePath

Menentukan jalur file yang digunakan untuk memperbarui sumber daya manajemen. Anda menentukan sumber daya manajemen dengan menggunakan parameter ResourceURI dan parameter SelectorSet. Misalnya, perintah berikut menggunakan parameter FilePath:

Invoke-WSManAction -Action StopService -ResourceUri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:C:\input.xml -Authentication Default

Perintah ini memanggil metode StopService pada layanan Spooler dengan menggunakan input dari file. File, Input.xml, berisi konten berikut:

<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Jalur

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Fragment

Menentukan bagian di dalam instans yang akan diperbarui atau diambil untuk operasi yang ditentukan. Misalnya, untuk mendapatkan status layanan penampung, tentukan -Fragment Status.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-OptionSet

Meneruskan sekumpulan sakelar ke layanan untuk memodifikasi atau menyempurnakan sifat permintaan. Ini mirip dengan sakelar yang digunakan dalam shell baris perintah karena spesifik 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}

Properti parameter

Jenis:	Hashtable
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	os

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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, maka nama umum sertifikat server tidak harus cocok dengan nama host server. Parameter SkipCNCheck harus digunakan hanya untuk komputer tepercaya.

Properti parameter

Jenis:	Int32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ResourceURI

Berisi Pengidentifikasi Sumber Daya Seragam (URI) dari kelas atau instans sumber daya. URI digunakan untuk mengidentifikasi jenis sumber daya tertentu, seperti disk atau proses, di komputer.

URI terdiri dari awalan dan jalur ke 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

Properti parameter

Jenis:	Uri
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	ruri

Kumpulan parameter

(All)

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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"}

Properti parameter

Jenis:	Hashtable
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	1
Wajib:	False
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-SessionOption

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

Properti parameter

Jenis:	SessionOption
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	jadi

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-UseSSL

Menentukan bahwa protokol Secure Sockets Layer (SSL) harus 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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	SSL

Kumpulan parameter

ComputerName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ValueSet

Menentukan tabel hash yang membantu memodifikasi sumber daya manajemen. Anda menentukan sumber daya manajemen dengan menggunakan parameter ResourceURI dan parameter SelectorSet. Nilai parameter ValueSet harus berupa tabel hash.

Properti parameter

Jenis:	Hashtable
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

XmlElement

Cmdlet ini mengembalikan instans WSMan yang diperbarui sebagai objek XmlElement.

Link Terkait

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