Rename-Computer

  • 參考
模組:
Microsoft.PowerShell.Management

重新命名電腦。

Syntax

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 參數。

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

-Confirm

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

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

-DomainCredential

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

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

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

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

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

-Force

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

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

-LocalCredential

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

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

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

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

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

-NewName

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

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

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

-PassThru

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

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

-Protocol

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

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

Type:String
Accepted values:DCOM, WSMan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Restart

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

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

-WhatIf

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

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

-WsmanAuthentication

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

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

預設值為 Default。

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

警告

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

此參數是在 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

輸入

None

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

輸出

None

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

RenameComputerChangeInfo

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