Rename-Computer
Mengganti nama komputer.
Sintaks
Default (Default)
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet ini hanya tersedia di platform Windows.
Cmdlet Rename-Computer mengganti nama komputer lokal atau komputer jarak jauh.
Ini mengganti nama satu komputer pada setiap perintah.
Cmdlet ini diperkenalkan di Windows PowerShell 3.0.
Contoh
Contoh 1: Mengganti nama komputer lokal
Perintah ini mengganti nama komputer lokal menjadi Server044 lalu memulai ulang agar perubahan efektif.
Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart
Contoh 2: Mengganti nama komputer jarak jauh
Perintah ini mengganti nama komputer Srv01 menjadi Server001. Komputer tidak dimulai ulang.
Parameter domainCredential menentukan kredensial pengguna yang memiliki izin untuk mengganti nama komputer di domain.
Parameter Force menghilangkan prompt konfirmasi.
Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force
Parameter
-ComputerName
Mengganti nama komputer jarak jauh yang ditentukan. Defaultnya adalah komputer lokal.
Ketik nama NetBIOS, alamat IP, atau nama domain komputer jarak jauh yang sepenuhnya memenuhi syarat.
Untuk menentukan komputer lokal, ketik nama komputer, titik (.), atau localhost.
Parameter ini tidak bergantung pada remoting PowerShell.
Anda dapat menggunakan parameter ComputerNameRename-Computer meskipun komputer Anda tidak dikonfigurasi untuk menjalankan perintah jarak jauh.
Properti parameter
| Jenis: | String |
| Nilai default: | Local Computer |
| 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 |
-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 |
-DomainCredential
Menentukan akun pengguna yang memiliki izin untuk menyambungkan ke domain. Kredensial eksplisit diperlukan untuk mengganti nama komputer yang bergabung ke domain.
Ketik nama pengguna, seperti User01 atau Domain01\User01, atau masukkan objek PSCredential, seperti yang dihasilkan oleh cmdlet Get-Credential.
Jika Anda mengetik nama pengguna, cmdlet ini akan meminta kata sandi kepada Anda.
Untuk menentukan akun pengguna yang memiliki izin untuk menyambungkan ke komputer yang ditentukan oleh parameter ComputerName, gunakan parameter LocalCredential.
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 |
-Force
Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.
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 |
-LocalCredential
Menentukan akun pengguna yang memiliki izin untuk menyambungkan ke komputer yang ditentukan oleh parameter ComputerName. Defaultnya adalah pengguna saat ini.
Ketik nama pengguna, seperti User01 atau Domain01\User01, atau masukkan objek PSCredential, seperti yang dihasilkan oleh cmdlet Get-Credential.
Jika Anda mengetik nama pengguna, cmdlet ini akan meminta kata sandi kepada Anda.
Untuk menentukan akun pengguna yang memiliki izin untuk menyambungkan ke domain, gunakan parameter domainCredential.
Properti parameter
| Jenis: | PSCredential |
| Nilai default: | Current User |
| 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 |
-NewName
Menentukan nama baru untuk komputer. Parameter ini diperlukan.
Nama standar mungkin berisi huruf (a-z), (A-Z), angka (0-9), dan tanda hubung (-), tetapi tidak ada spasi atau titik (.). Nama mungkin tidak sepenuhnya terdiri dari digit, dan mungkin tidak lebih dari 63 karakter
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-PassThru
Mengembalikan hasil perintah. Jika tidak, cmdlet ini tidak menghasilkan output apa pun.
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 |
-Restart
Menunjukkan bahwa cmdlet ini memulai ulang komputer yang diganti namanya. Mulai ulang sering diperlukan untuk membuat perubahan efektif.
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 |
-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 |
-WsmanAuthentication
Menentukan mekanisme yang digunakan untuk mengautentikasi kredensial pengguna ketika cmdlet ini menggunakan protokol WSMan. Nilai yang dapat diterima untuk parameter ini adalah:
- Dasar
- CredSSP
- Default
- Digest
- Kerberos
- Negosiasi
Nilai defaultnya adalah Default.
Untuk informasi selengkapnya tentang nilai parameter ini, lihat AuthenticationMechanism Enumeration.
Peringatan
Autentikasi Penyedia Layanan Keamanan Kredensial (CredSSP), di mana kredensial pengguna diteruskan ke komputer jarak jauh untuk diautentikasi, dirancang untuk perintah yang memerlukan autentikasi pada lebih dari satu sumber daya, seperti mengakses berbagi jaringan jarak jauh. Mekanisme ini meningkatkan risiko keamanan operasi jarak jauh. Jika komputer jarak jauh disusupi, kredensial yang diteruskan ke komputer jarak jauh dapat digunakan untuk mengontrol > sesi jaringan.
Parameter ini diperkenalkan di Windows PowerShell 3.0.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Nilai yang diterima: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| 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 |
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
Cmdlet ini tidak memiliki parameter yang mengambil input berdasarkan nilai. Namun, Anda dapat mengalirkan nilai properti ComputerName dan NewName dari objek ke cmdlet ini.
Output
None
Secara default, cmdlet ini tidak mengembalikan output apa pun.
RenameComputerChangeInfo
Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek RenameComputerChangeInfo.
Catatan
Cmdlet ini hanya tersedia di platform Windows.
