Rename-Computer

  • Referensi
Modul:
Microsoft.PowerShell.Management

Mengganti nama komputer.

Sintaks

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.

Rename-Computer Cmdlet mengganti nama komputer lokal atau komputer jarak jauh. Ini mengganti nama satu komputer di 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 Srv01 komputer menjadi Server001. Komputer tidak dimulai ulang.

Parameter DomainCredential menentukan kredensial pengguna yang memiliki izin untuk mengganti nama komputer di domain.

Parameter Force menekan 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 Rename-Computer ComputerName meskipun komputer Anda tidak dikonfigurasi untuk menjalankan perintah jarak jauh.

Type:String
Position:Named
Default value:Local Computer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Get-Credential cmdlet.

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 .

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

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Get-Credential cmdlet.

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 .

Type:PSCredential
Position:Named
Default value:Current User
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Menentukan nama baru untuk komputer. Parameter ini diperlukan.

Nama standar mungkin berisi huruf (), (A-Z), angka (0-9), dan tanda hubung (-), tetapi tidak ada spasi atau titik (.).a-z Nama mungkin tidak sepenuhnya terdiri dari digit, dan mungkin tidak lebih dari 63 karakter

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

-PassThru

Mengembalikan hasil perintah. Jika tidak, cmdlet ini tidak menghasilkan output apa pun.

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

-Restart

Menunjukkan bahwa cmdlet ini memulai ulang komputer yang diganti namanya. Mulai ulang sering diperlukan untuk membuat perubahan efektif.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
  • Mencerna
  • Kerberos
  • Bernegosiasi

Nilai defaultnya adalah Default.

Untuk informasi selengkapnya tentang nilai parameter ini, lihat Enumerasi AuthenticationMechanism.

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.

Type:String
Accepted values:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Cmdlet ini tidak memiliki parameter yang mengambil input berdasarkan nilai. Namun, Anda dapat menyalurkan nilai properti ComputerName dan NewName 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.