Bagikan melalui

Test-ComputerSecureChannel

Modul:
Microsoft.PowerShell.Management Module

Menguji dan memperbaiki saluran aman antara komputer lokal dan domainnya.

Sintaks

Default (Default) 

Test-ComputerSecureChannel
    [-Repair]
    [-Server <String>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

Cmdlet Test-ComputerSecureChannel memverifikasi bahwa saluran antara komputer lokal dan domainnya berfungsi dengan benar dengan memeriksa status hubungan kepercayaannya. Jika koneksi gagal, Anda dapat menggunakan parameter Perbaiki untuk mencoba memulihkannya.

Test-ComputerSecureChannel mengembalikan $true jika saluran berfungsi dengan benar dan $false jika tidak. Hasil ini memungkinkan Anda menggunakan cmdlet dalam pernyataan bersyarkat dalam fungsi dan skrip. Untuk mendapatkan hasil pengujian yang lebih rinci, gunakan parameter Verbose.

Cmdlet ini berfungsi seperti NetDom.exe. Baik NetDom maupun Test-ComputerSecureChannel menggunakan layanan NetLogon untuk melakukan tindakan.

Nota

Cmdlet ini hanya berfungsi pada komputer Anggota Domain. Saat Anda menjalankannya di Pengendali Domain, ia mengembalikan kesalahan positif palsu. Untuk memverifikasi dan mengatur ulang saluran aman untuk Pengendali Domain, gunakan netdom.exe atau nltest.exe.

Contoh

Contoh 1: Menguji saluran antara komputer lokal dan domainnya

Test-ComputerSecureChannel

Perintah ini menguji saluran antara komputer lokal dan domain tempatnya bergabung.

Contoh 2: Menguji saluran antara komputer lokal dan pengendali domain

Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

Perintah ini menentukan pengendali domain pilihan untuk pengujian.

Contoh 3: Mereset saluran antara komputer lokal dan domainnya

Test-ComputerSecureChannel -Repair

Perintah ini mereset saluran antara komputer lokal dan domainnya.

Contoh 4: Menampilkan informasi terperinci tentang pengujian

Test-ComputerSecureChannel -Verbose

VERBOSE: Performing operation "Test-ComputerSecureChannel" on Target "SERVER01".
True
VERBOSE: "The secure channel between 'SERVER01' and 'net.fabrikam.com' is alive and working correctly."

Perintah ini menggunakan parameter umum Verbose untuk meminta pesan terperinci tentang operasi. Untuk informasi selengkapnya tentang Verbose, lihat about_CommonParameters.

Contoh 5: Menguji koneksi sebelum Anda menjalankan skrip

if (!(Test-ComputerSecureChannel)) {
    Write-Host "Connection failed. Reconnect and retry."
}
else {
    &(.\Get-Servers.ps1)
}

Contoh ini menunjukkan cara menggunakan Test-ComputerSecureChannel untuk menguji koneksi sebelum Anda menjalankan skrip yang memerlukan koneksi.

Pernyataan if memeriksa nilai yang Test-ComputerSecureChannel kembalikan sebelum menjalankan skrip.

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Kumpulan parameter

(All)
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. Ketik nama pengguna, seperti User01 atau Domain01\User01, atau masukkan objek PSCredential , seperti yang dikembalikan cmdlet Get-Credential. Secara default, cmdlet menggunakan kredensial pengguna saat ini.

Parameter Kredensial dirancang untuk digunakan dalam perintah yang menggunakan parameter Perbaikan untuk memperbaiki saluran antara komputer dan domain.

Properti parameter

Jenis:PSCredential
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

-Repair

Menunjukkan bahwa cmdlet ini menghapus dan kemudian membangun kembali saluran yang dibuat oleh layanan NetLogon. Gunakan parameter ini untuk mencoba memulihkan koneksi yang gagal dalam pengujian.

Untuk menggunakan parameter ini, pengguna saat ini harus menjadi anggota grup Administrator pada komputer lokal.

Properti parameter

Jenis:SwitchParameter
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

-Server

Menentukan pengendali domain untuk menjalankan perintah. Jika parameter ini tidak ditentukan, cmdlet ini memilih pengendali domain default untuk operasi.

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

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
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 input ke cmdlet ini.

Output

Boolean

Cmdlet ini mengembalikan $true jika koneksi berfungsi dengan benar dan $false jika tidak.

Catatan

  • Untuk menjalankan perintah Test-ComputerSecureChannel pada Windows Vista dan versi sistem operasi Windows yang lebih baru, buka Windows PowerShell dengan menggunakan opsi Jalankan sebagai administrator.
  • Test-ComputerSecureChannel diimplementasikan dengan menggunakan fungsi I_NetLogonControl2, yang mengontrol berbagai aspek layanan Netlogon.