Move-ItemProperty

構文

Path (既定)

Move-ItemProperty
    [-Path] <String[]>
    [-Name] <String[]>
    [-Destination] <String>
    [-PassThru]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LiteralPath

Move-ItemProperty
    [-Name] <String[]>
    [-Destination] <String>
    -LiteralPath <String[]>
    [-PassThru]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

例

例 1: レジストリ値とそのデータを別のキーに移動する

$moveParams = @{
    Path        = "HKLM:\Software\MyCompany\MyApp"
    Name        = "Version"
    Destination = "HKLM:\Software\MyCompany\NewApp"
}
Move-ItemProperty @moveParams

パラメーター

-Confirm

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

パラメーターのプロパティ

パラメーター セット

-Credential

パラメーターのプロパティ

パラメーター セット

-Destination

移動先の場所へのパスを指定します。

パラメーターのプロパティ

パラメーター セット

-Exclude

文字列配列として、このコマンドレットが操作で除外する項目を指定します。 このパラメーターの値は、Path パラメーターを修飾します。 パス要素またはパターン (*.txtなど) を入力します。 ワイルドカード文字を使用できます。 Exclude パラメーターは、コマンドに項目の内容 (C:\Windows\*など) が含まれている場合にのみ有効です。ワイルドカード文字は、C:\Windows ディレクトリの内容を指定します。

パラメーターのプロパティ

パラメーター セット

-Filter

Path パラメーターを修飾するフィルターを指定します。 FileSystem プロバイダーは、フィルターの使用をサポートする唯一のインストール済み PowerShell プロバイダーです。 FileSystem フィルター言語の構文は about_Wildcardsに記載されています。 フィルターは、取得後に PowerShell でオブジェクトをフィルター処理するのではなく、コマンドレットがオブジェクトを取得するときにプロバイダーによって適用されるため、他のパラメーターよりも効率的です。

パラメーターのプロパティ

パラメーター セット

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。 実装はプロバイダーによって異なります。 詳細については、about_Providersを参照してください。

パラメーターのプロパティ

パラメーター セット

-Include

文字列配列として、このコマンドレットが操作に含める項目を指定します。 このパラメーターの値は、Path パラメーターを修飾します。 パス要素またはパターン ("*.txt"など) を入力します。 ワイルドカード文字を使用できます。 Include パラメーターは、コマンドに項目の内容 (ワイルドカード文字が C:\Windows\* ディレクトリの内容を指定する C:\Windowsなど) が含まれている場合にのみ有効です。

パラメーターのプロパティ

パラメーター セット

-LiteralPath

1 つ以上の場所へのパスを指定します。 LiteralPath の値は、入力されたとおりにそのまま使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 単一引用符は、エスケープ シーケンスとして文字を解釈しないように PowerShell に指示します。

詳細については、about_Quoting_Rulesを参照してください。

パラメーターのプロパティ

パラメーター セット

-Name

移動するプロパティの名前を指定します。

パラメーターのプロパティ

パラメーター セット

-PassThru

作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しません。

パラメーターのプロパティ

パラメーター セット

-Path

プロパティの現在の場所へのパスを指定します。 ワイルドカード文字を使用できます。

パラメーターのプロパティ

パラメーター セット

-WhatIf

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

パラメーターのプロパティ

パラメーター セット

CommonParameters

入力

String

出力

None

PSCustomObject

メモ

関連リンク

• Clear-ItemProperty
• Copy-ItemProperty（アイテムプロパティをコピー）
• Get-ItemProperty
• New-ItemProperty
• Remove-ItemProperty
• アイテムプロパティの名前を変更
• アイテムプロパティ設定（Set-ItemProperty）
• プロバイダについて