Rename-Computer
重新命名電腦。
語法
Default (預設值)
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
此 Cmdlet 只能在 Windows 平臺上使用。
指令 Rename-Computer 本檔會重新命名本地電腦或遠端電腦。 它會在每個指令中重新命名一台電腦。
此 Cmdlet 已在 Windows PowerShell 3.0 中引進。
範例
範例 1：重新命名本地電腦
此指令將本地電腦重新命名為 ， Server044 然後重新啟動，使變更有效。
Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart
範例 2：重新命名遠端電腦
此指令將電腦重新命名 Srv01 為 Server001。 電腦沒有重新啟動。
DomainCredential 參數指定有權重新命名網域中電腦的使用者憑證。
「 力」 參數會隱藏確認提示。
$renameParams = @{
ComputerName = "Srv01"
NewName = "Server001"
DomainCredential = "Domain01\Admin01"
Force = $true
}
Rename-Computer @renameParams
參數
-ComputerName
重新命名指定的遠端電腦。 預設值為本機電腦。
輸入 NetBIOS 名稱、IP 位址，或遠端電腦的完整限定網域名稱。
要指定本地電腦，請輸入電腦名稱、點（）、.或 localhost。
此參數不依賴 PowerShell 遠端處理。
即使您的電腦未設定為執行遠端命令，您也可以使用 的 Rename-Computer 參數。
參數屬性
| 類型: | String |
| 預設值: | Local Computer |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 參見 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainCredential
指定一個有權限連接該網域的使用者帳號。 若要重新命名已加入網域的電腦，必須使用明確憑證。
輸入使用者名稱，例如 User01 或 Domain01\User01，或輸入 PSCredential 物件，例如 Get-Credential Cmdlet 所產生的用戶名稱。
如果您輸入使用者名稱，此 Cmdlet 會提示您輸入密碼。
若要指定一個有權限連接到 ComputerName 參數所指定的電腦的使用者帳號，請使用 LocalCredential 參數。
參數屬性
| 類型: | PSCredential |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
強制命令執行，而不要求使用者確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-LocalCredential
指定一個使用者帳號，該帳號有權限連接到由 ComputerName 參數指定的電腦。 預設值為目前的使用者。
輸入使用者名稱，例如 User01 或 Domain01\User01，或輸入 PSCredential 物件，例如 Get-Credential Cmdlet 所產生的用戶名稱。
如果您輸入使用者名稱，此 Cmdlet 會提示您輸入密碼。
若要指定有權限連接該網域的使用者帳號，請使用 DomainCredential 參數。
參數屬性
| 類型: | PSCredential |
| 預設值: | Current User |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NewName
指定電腦的新名稱。 此為必要參數。
標準名稱可包含字母（a-z）、（）、A-Z數字（0-9）、連字號（-），但不包含空格或句點（.）。 名稱可能不完全由數字組成，且長度不得超過63個字元
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-PassThru
回傳指令的結果。 否則，此 Cmdlet 不會產生任何輸出。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Restart
表示此指令檔會重新啟動已重新命名的電腦。 通常需要重新啟動才能使變更生效。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 指令未執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 威斯康辛 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WsmanAuthentication
規定當此指令小程式使用 WSMan 協定時，用於驗證使用者憑證的機制。 此參數可接受的值為：
- 基本
- CredSSP
- 預設值
- 摘要
- Kerberos
- 交涉
預設值為 Default。
如需此參數值的詳細資訊，請參閱 AuthenticationMechanism 列舉。
Warning
憑證安全服務提供者（CredSSP）認證，即將使用者憑證傳送至遠端電腦進行驗證，設計用於需要在多個資源上進行認證的指令，例如存取遠端網路共享。 此機制會增加遠端作業的安全性風險。 若遠端電腦遭到入侵，傳給它的憑證可用來控制 > 網路會話。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | String |
| 預設值: | None |
| 接受的值: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
None
這個指令檔沒有參數會以值來接收輸入。 不過，你可以將物件的 ComputerName 和 NewName 屬性的值管道輸入這個 cmdlet。
輸出
None
預設情況下，這個指令檔不會回傳任何輸出。
RenameComputerChangeInfo
當你使用 PassThru 參數時，這個 cmdlet 會回傳一個 RenameComputerChangeInfo 物件。
備註
此 Cmdlet 僅適用於 Windows 平臺。
