Rename-Computer
重新命名電腦。
語法
Default (預設值)
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rename-Computer Cmdlet 會重新命名本機電腦或遠端電腦。
它會在每個命令中重新命名一部計算機。
此 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 參數。
參數屬性
| 類型: | String |
| 預設值: | Local Computer |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(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 |
| 預設值: | False |
| 支援萬用字元: | 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 |
-Protocol
指定要用來重新命名計算機的通訊協定。 此參數可接受的值為：WSMan 和 DCOM。 預設值為 DCOM。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | String |
| 預設值: | None |
| 接受的值: | DCOM, WSMan |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Restart
表示此 Cmdlet 會重新啟動重新命名的電腦。 通常需要重新啟動才能使變更生效。
參數屬性
| 類型: | 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
指定當此 Cmdlet 使用 WSMan 通訊協定時，用來驗證使用者認證的機制。 此參數可接受的值為：
- 基本
- CredSSP
- 預設值
- 摘要
- Kerberos
- 交涉
預設值為 Default。
如需此參數值的詳細資訊，請參閱 AuthenticationMechanism 列舉。
警告
認證安全性服務提供者 （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
此 Cmdlet 沒有依值接受輸入的參數。 不過，您可以將物件的 ComputerName 和 NewName 屬性值管線傳送到這個 Cmdlet。
輸出
ComputerChangeInfo
如果您 指定 passThru 參數，這個 Cmdlet 會傳回 ComputerChangeInfo 物件。 否則，它不會傳回任何輸出。