Rename-Computer
コンピューターの名前を変更します。
構文
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 パラメーターは、確認プロンプトを抑制します。
Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force
パラメーター
-ComputerName
指定したリモート コンピューターの名前を変更します。 既定値はローカル コンピューターです。
リモート コンピューターの NetBIOS 名、IP アドレス、または完全修飾ドメイン名を入力します。
ローカル コンピューターを指定するには、コンピューター名、ドット (.
)、または localhost
を入力します。
このパラメーターは、PowerShell リモート処理には依存しません。
コンピューターがリモート コマンドを実行するように構成されていない場合でも、Rename-Computer
の ComputerName パラメーターを使用できます。
型: | String |
配置: | Named |
規定値: | Local Computer |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DomainCredential
ドメインに接続するアクセス許可を持つユーザー アカウントを指定します。 ドメインに参加しているコンピューターの名前を変更するには、明示的な資格情報が必要です。
User01
やDomain01\User01
などのユーザー名を入力するか、Get-Credential
コマンドレットによって生成されたPSCredential オブジェクトを入力します。
ユーザー名を入力すると、このコマンドレットによってパスワードの入力が求められます。
ComputerName パラメーターで指定されたコンピューターに接続するアクセス許可を持つユーザー アカウントを指定するには、LocalCredential パラメーターを使用します。
型: | PSCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-LocalCredential
ComputerName パラメーターで指定されたコンピューターに接続するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。
User01
やDomain01\User01
などのユーザー名を入力するか、Get-Credential
コマンドレットによって生成されたPSCredential オブジェクトを入力します。
ユーザー名を入力すると、このコマンドレットによってパスワードの入力が求められます。
ドメインに接続するアクセス許可を持つユーザー アカウントを指定するには、 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
- 既定値
- Digest
- Kerberos
- 交渉する
既定値は Defaultです。
このパラメーターの値の詳細については、「 AuthenticationMechanism 列挙型を参照してください。
警告
資格情報セキュリティ サービス プロバイダー (CredSSP) 認証は、ユーザー資格情報が認証されるリモート コンピューターに渡される認証で、リモート ネットワーク共有へのアクセスなど、複数のリソースで認証を必要とするコマンド用に設計されています。 このメカニズムを使用すると、リモート操作のセキュリティ リスクが高まります。 リモート コンピューターが侵害された場合、それに渡される資格情報を使用して、ネットワーク セッション > 制御できます。
このパラメーターは Windows PowerShell 3.0 で導入されました。
型: | String |
指定可能な値: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
このコマンドレットには、値によって入力を受け取るパラメーターがありません。 ただし、オブジェクトの ComputerName プロパティと NewName プロパティの値をこのコマンドレットにパイプできます。
出力
None
既定では、このコマンドレットは出力を返しません。
PassThru パラメーターを使用すると、このコマンドレットは RenameComputerChangeInfo オブジェクトを返します。
メモ
このコマンドレットは、Windows プラットフォームでのみ使用できます。
関連リンク
PowerShell