Rename-AzStorageFile
ファイルの名前を変更します。
構文
Rename-AzStorageFile
[-ShareName] <String>
[-SourcePath] <String>
[[-DestinationPath] <String>]
[-ContentType <String>]
[-Permission <String>]
[-DisAllowSourceTrailingDot]
[-DisAllowDestTrailingDot]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[-IgnoreReadonly]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Rename-AzStorageFile
[-ShareFileClient] <ShareFileClient>
[[-DestinationPath] <String>]
[-ContentType <String>]
[-Permission <String>]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[-IgnoreReadonly]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Rename-AzStorageFile
[-ShareClient] <ShareClient>
[-SourcePath] <String>
[[-DestinationPath] <String>]
[-ContentType <String>]
[-Permission <String>]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[-IgnoreReadonly]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Rename-AzStorageFile
[-ShareDirectoryClient] <ShareDirectoryClient>
[-SourcePath] <String>
[[-DestinationPath] <String>]
[-ContentType <String>]
[-Permission <String>]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[-IgnoreReadonly]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Rename-AzStorageFile コマンドレットは、ファイル共有からディレクトリの名前を変更します。
例
例 1: ファイル共有からファイルの名前を変更する
Rename-AzStorageFile -SourcePath testfile1 -DestinationPath testfile2 -ShareName myshare
Directory: https://myaccount.file.core.windows.net/myshare
Type Length Name
---- ------ ----
File 512 testfile2
このコマンドは、ファイル共有 myshare でファイルの名前を testfile1 から testfile2 に変更します。
例 2: パイプラインを使用してファイル共有からファイルの名前を変更する
Get-AzStorageFile -ShareName myshare -Path testfile1 | Rename-AzStorageFile -DestinationPath testfile2
Directory: https://myaccount.file.core.windows.net/myshare
Type Length Name
---- ------ ----
File 512 testfile2
このコマンドは、最初にファイル クライアント オブジェクトを取得し、パイプラインを使用してファイルの名前を testfile1 から testfile2 に変更します。
パラメーター
-AsJob
バックグラウンドでコマンドレットを実行する
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ContentType
ファイルの MIME コンテンツ タイプを設定します。 既定の型は 'application/octet-stream' です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Context
Azure Storage Context オブジェクト
型: | IStorageContext |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DestinationPath
ファイルの名前を変更する宛先パス。
型: | String |
配置: | 1 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisAllowDestTrailingDot
末尾のドット (.) を宛先ディレクトリ名と宛先ファイル名のサフィックスに設定しないようにします。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisAllowSourceTrailingDot
末尾のドット (.) を、ソース ディレクトリ名とソース ファイル名にサフィックス付けしないようにします。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
既存のファイルを強制的に上書きします。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IgnoreReadonly
省略可能。 既存の宛先ファイルの ReadOnly 属性を尊重するかどうかを指定します。 true の場合、名前の変更は成功し、それ以外の場合は、ReadOnly 属性が設定された変換先の前のファイルで名前の変更が失敗します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Permission
指定した場合、ディレクトリ/ファイルにアクセス許可 (セキュリティ記述子) を設定する必要があります。 既定値: 継承します。 SDDL が入力として指定されている場合は、所有者、グループ、および dacl が必要です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ShareClient
ShareClient は、ファイルが一覧表示される共有を示しました。
型: | ShareClient |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ShareDirectoryClient
ShareDirectoryClient は、ファイルが一覧表示される共有を示しました。
型: | ShareDirectoryClient |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ShareFileClient
ソース ファイル インスタンス
型: | ShareFileClient |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ShareName
ファイルが一覧表示されるファイル共有の名前。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SourcePath
既存のファイルへのパス。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
出力
Azure PowerShell