Rename-Computer

モジュール:

Microsoft.PowerShell.Management

コンピューターの名前を変更します。

構文

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

説明

このコマンドレットは、Windows プラットフォームでのみ使用できます。

コマンドレットは Rename-Computer 、ローカル コンピューターまたはリモート コンピューターの名前を変更します。 各コマンドで 1 つのコンピューターの名前を変更します。

このコマンドレットは、Windows PowerShell 3.0 で導入されました。

例

例 1: ローカル コンピューターの名前を変更する

このコマンドは、ローカル コンピューターの名前を Server044 変更してから再起動して、変更を有効にします。

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

例 2: リモート コンピューターの名前を変更する

このコマンドは、コンピューターの名前を にSrv01Server001変更します。 コンピューターは再起動されません。

DomainCredential パラメーターは、ドメイン内のコンピューターの名前を変更するアクセス許可を持つユーザーの資格情報を指定します。

Force パラメーターは、確認プロンプトを抑制します。

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

パラメーター

-ComputerName

指定したリモート コンピューターの名前を変更します。 既定値はローカル コンピューターです。

リモート コンピューターの NetBIOS 名、IP アドレス、または完全修飾ドメイン名を入力します。 ローカル コンピューターを指定するには、コンピューター名、ドット (.)、または localhost.

このパラメーターは、PowerShell リモート処理には依存しません。 コンピューターがリモート コマンドを実行するように構成されていない場合でも、 ComputerName パラメーター Rename-Computer を使用できます。

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-DomainCredential

ドメインに接続するアクセス許可を持つユーザー アカウントを指定します。 ドメインに参加しているコンピューターの名前を変更するには、明示的な資格情報が必要です。

コマンドレットによってGet-Credential生成されたものなどUser01、PSCredential オブジェクトなどのユーザー名を入力するかDomain01\User01、入力します。

ユーザー名を入力すると、このコマンドレットによってパスワードの入力が求められます。

ComputerName パラメーターで指定されたコンピューターに接続するアクセス許可を持つユーザー アカウントを指定するには、LocalCredential パラメーターを使用します。

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

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

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

-LocalCredential

ComputerName パラメーターで指定されたコンピューターに接続するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。

コマンドレットによってGet-Credential生成されたものなどUser01、PSCredential オブジェクトなどのユーザー名を入力するかDomain01\User01、入力します。

ユーザー名を入力すると、このコマンドレットによってパスワードの入力が求められます。

ドメインに接続するアクセス許可を持つユーザー アカウントを指定するには、DomainCredential パラメーターを使用します。

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

-NewName

コンピューターの新しい名前を指定します。 このパラメーターは必須です。

標準名には、文字 (a-z)、(A-Z)、数値 (0-9)、ハイフン (-) を含めることができますが、スペースやピリオド (.) は含めてはなりません。 名前は完全に数字で構成されるのではなく、63 文字以下である場合もあります。

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

-PassThru

コマンドの結果を返します。 それ以外の場合、このコマンドレットによる出力はありません。

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

-Restart

このコマンドレットは、名前が変更されたコンピューターを再起動することを示します。 多くの場合、変更を有効にするには再起動が必要です。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

-WsmanAuthentication

このコマンドレットで WSMan プロトコルを使用する場合に、ユーザー資格情報の認証に使用されるメカニズムを指定します。 このパラメーターの有効値は、次のとおりです。

• Basic
• 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
Accept pipeline input:	False
Accept wildcard characters:	False

入力

None

このコマンドレットには、値による入力を受け取るパラメーターはありません。 ただし、パイプを使用してオブジェクトの ComputerName および NewName プロパティの値をこのコマンドレットに渡すことはできます。

出力

ComputerChangeInfo

PassThru パラメーターを指定すると、このコマンドレットは ComputerChangeInfo オブジェクトを返します。 それ以外の場合、出力は返しません。

メモ

このコマンドレットは、Windows プラットフォームでのみ使用できます。

関連リンク

• Restart-Computer
• Stop-Computer