共用方式為


Rename-Computer

重新命名電腦。

語法

Rename-Computer
      [-ComputerName <String>]
      [-PassThru]
      [-DomainCredential <PSCredential>]
      [-LocalCredential <PSCredential>]
      [-NewName] <String>
      [-Force]
      [-Restart]
      [-WsmanAuthentication <String>]
      [-Protocol <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdlet 會 Rename-Computer 重新命名本機電腦或遠端電腦。 它會在每個命令中重新命名一部計算機。

此 Cmdlet 已在 Windows PowerShell 3.0 中引進。

範例

範例 1:重新命名本機計算機

此命令會將本機計算機重新命名為 Server044 ,然後重新啟動它,讓變更生效。

Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart

範例 2:重新命名遠端電腦

這個指令會將 Srv01 電腦重新命名為 Server001。 計算機未重新啟動。

DomainCredential 參數會指定有權重新命名網域中計算機的用戶認證。

Force 參數會隱藏確認提示。

Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force

參數

-ComputerName

重新命名指定的遠端電腦。 預設是本機電腦。

輸入 NetBIOS 名稱、IP 位址或遠端電腦的完整功能變數名稱。 若要指定本機電腦,請輸入電腦名稱、點 (.), 或 localhost

此參數不依賴 PowerShell 遠端處理。 即使您的電腦未設定為執行遠端命令,您也可以使用 Rename-Computer ComputerName 參數。

類型:String
Position:Named
預設值:Local Computer
必要:False
接受管線輸入:True
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-DomainCredential

指定有權連線到網域的用戶帳戶。 需要明確認證,才能重新命名已加入網域的計算機。

輸入使用者名稱,例如 User01Domain01\User01,或輸入 PSCredential 物件,例如 Cmdlet 所產生的 Get-Credential 用戶名稱。

如果您輸入使用者名稱,此 Cmdlet 會提示您輸入密碼。

若要指定有權連線到 ComputerName 參數所指定電腦的用戶帳戶,請使用 LocalCredential 參數。

類型:PSCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Force

強制命令執行,而不要求使用者確認。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LocalCredential

指定有權連線到 ComputerName 參數所指定電腦的用戶帳戶。 預設為目前使用者。

輸入使用者名稱,例如 User01Domain01\User01,或輸入 PSCredential 物件,例如 Cmdlet 所產生的 Get-Credential 用戶名稱。

如果您輸入使用者名稱,此 Cmdlet 會提示您輸入密碼。

若要指定有權連線到網域的用戶帳戶,請使用 DomainCredential 參數。

類型:PSCredential
Position:Named
預設值:Current User
必要:False
接受管線輸入:False
接受萬用字元:False

-NewName

指定電腦的新名稱。 此為必要參數。

標準名稱可能包含字母(a-z)、(A-Z)、數位(0-9)和連字元(-),但沒有空格或句號(.)。 名稱可能未完全包含數位,且長度可能不超過63個字元

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-PassThru

傳回命令的結果。 否則,此 Cmdlet 不會產生任何輸出。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Protocol

指定要用來重新命名計算機的通訊協定。 此參數可接受的值為:WSMan 和 DCOM。 預設值為 DCOM。

此參數是在 Windows PowerShell 3.0 中引進的。

類型:String
接受的值:DCOM, WSMan
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Restart

表示此 Cmdlet 會重新啟動重新命名的電腦。 通常需要重新啟動才能使變更生效。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-WsmanAuthentication

指定當此 Cmdlet 使用 WSMan 通訊協定時,用來驗證使用者認證的機制。 此參數可接受的值為:

  • 基本
  • CredSSP
  • Default
  • 消化
  • Kerberos
  • 談判

預設值為 Default

如需此參數值的詳細資訊,請參閱 AuthenticationMechanism 列舉

警告

認證安全性服務提供者 (CredSSP) 驗證,其中使用者認證會傳遞至要驗證的遠端電腦,是針對需要驗證多個資源的命令所設計,例如存取遠端網路共用。 此機制會增加遠端作業的安全性風險。 如果遠端電腦遭到入侵,傳遞給它的認證可用來控制 > 網路會話。

此參數是在 Windows PowerShell 3.0 中引進的。

類型:String
接受的值:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

None

此 Cmdlet 沒有依值接受輸入的參數。 不過,您可以使用管線將 物件的 ComputerNameNewName 屬性值傳送至此 Cmdlet。

輸出

None

根據預設,此 Cmdlet 不會傳回任何輸出。

RenameComputerChangeInfo

當您使用 PassThru 參數時,這個 Cmdlet 會 傳回 RenameComputerChangeInfo 物件。