次の方法で共有

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: リモート コンピューターの名前を変更する

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

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

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

$renameParams = @{
    ComputerName = "Srv01"
    NewName = "Server001"
    DomainCredential = "Domain01\Admin01"
    Force = $true
}
Rename-Computer @renameParams

パラメーター

-ComputerName

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

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

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

型:String
配置:Named
規定値:Local Computer
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DomainCredential

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

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

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

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

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LocalCredential

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

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

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

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

型:PSCredential
配置:Named
規定値:Current User
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-NewName

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

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

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PassThru

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Restart

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WsmanAuthentication

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

  • ベーシック
  • CredSSP
  • デフォルト
  • ダイジェスト
  • Kerberos
  • ネゴシエイト

既定値は Defaultです。

このパラメーターの値の詳細については、「AuthenticationMechanism 列挙を参照してください。

警告

資格情報セキュリティ サービス プロバイダー (CredSSP) 認証は、ユーザー資格情報が認証されるリモート コンピューターに渡される認証で、リモート ネットワーク共有へのアクセスなど、複数のリソースで認証を必要とするコマンド用に設計されています。 このメカニズムにより、リモート操作のセキュリティ リスクが高まります。 リモート コンピューターが侵害された場合、それに渡される資格情報を使用して、ネットワーク セッション > 制御できます。

このパラメーターは、Windows PowerShell 3.0 で導入されました。

型:String
指定可能な値:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

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

出力

None

既定では、このコマンドレットは出力を返しません。

RenameComputerChangeInfo

PassThru パラメーターを使用すると、このコマンドレットは RenameComputerChangeInfo オブジェクトを返します。

メモ

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