Get-AzStorageFile
構文
ShareName (既定)
Get-AzStorageFile
[-ShareName] <String>
[[-Path] <String>]
[-ExcludeExtendedInfo]
[-DisAllowTrailingDot]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Share
Get-AzStorageFile
[-ShareClient] <ShareClient>
[[-Path] <String>]
[-ExcludeExtendedInfo]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Directory
Get-AzStorageFile
[-ShareDirectoryClient] <ShareDirectoryClient>
[[-Path] <String>]
[-ExcludeExtendedInfo]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
説明
Get-AzStorageFile コマンドレットは、指定した共有またはディレクトリのディレクトリとファイルを一覧表示します。
Path パラメーターを指定して、指定したパス内のディレクトリまたはファイルのインスタンスを取得します。
このコマンドレットは、AzureStorageFileAzureStorageDirectory オブジェクト返します。
IsDirectory プロパティを使用すると、フォルダーとファイルを区別できます。
例
例 1: 共有内のディレクトリを一覧表示する
Get-AzStorageFile -ShareName "ContosoShare06" | Where-Object {$_.GetType().Name -eq "AzureStorageFileDirectory"}
このコマンドは、共有 ContosoShare06 内のディレクトリのみを一覧表示します。
最初に、ファイルとディレクトリの両方を取得し、パイプライン演算子を使用して where 演算子に渡し、その後、型が "AzureStorageFileDirectory" でないオブジェクトをすべて破棄します。
例 2: ファイル ディレクトリを一覧表示する
Get-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzStorageFile
このコマンドは、ContosoShare06 共有の下にある ContosoWorkingFolder ディレクトリ内のファイルとフォルダーを一覧表示します。
最初にディレクトリ インスタンスを取得し、 Get-AzStorageFile コマンドレットにパイプライン処理してディレクトリを一覧表示します。
例 3: 共有内のファイルとディレクトリを一覧表示し、拡張情報を除外する
Get-AzStorageFile -ShareName "ContosoShare06" -ExcludeExtendedInfo
このコマンドは、共有 ContosoShare06 の下にあるファイルとフォルダーを一覧表示し、タイムスタンプ、ETag、属性、permissionKey などの拡張ファイル情報をリスト ファイルとディレクトリから除外します。
現在、NFS ファイル共有または NFS ファイル共有内のディレクトリのファイルとディレクトリを一覧表示するには、 -ExcludeExtendedInfo が必要です。
パラメーター
-ClientTimeoutPerRequest
1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。
指定した時間内に前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。
間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。
パラメーターのプロパティ
型: | Nullable<T>[Int32]
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ClientTimeoutPerRequestInSeconds |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ConcurrentTaskCount
同時ネットワーク呼び出しの最大数を指定します。
このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。
指定した値は絶対カウントであり、コア数には乗算されません。
このパラメーターは、1 秒あたり 100 キロビットなどの低帯域幅環境でのネットワーク接続の問題を軽減するのに役立ちます。
既定値は 10 です。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Context
Azure Storage コンテキストを指定します。
ストレージ コンテキストを取得するには、New-AzStorageContext コマンドレットを使用します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DisAllowTrailingDot
末尾のドット (.) をディレクトリ名とファイル名にサフィックス付けしないようにします。
パラメーターのプロパティ
パラメーター セット
ShareName
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ExcludeExtendedInfo
タイムスタンプ、ETag、属性、permissionKey などの拡張ファイル情報をリスト ファイルやディレクトリに含めないでください。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Path
フォルダーのパスを指定します。
Path パラメーターを省略すると、Get-AzStorageFile 指定したファイル共有またはディレクトリ内のディレクトリとファイルが一覧表示されます。
Path パラメーターを含める場合、Get-AzStorageFile は指定したパス内のディレクトリまたはファイルのインスタンスを返します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | 1 |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ServerTimeoutPerRequest
要求のサービス側タイムアウト間隔を秒単位で指定します。
サービスが要求を処理する前に指定した間隔が経過すると、Storage サービスはエラーを返します。
パラメーターのプロパティ
型: | Nullable<T>[Int32]
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ServerTimeoutPerRequestInSeconds |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ShareClient
ShareClient オブジェクトは、ファイル/ディレクトリが一覧表示される共有を示しました。
パラメーターのプロパティ
型: | ShareClient
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
Share
配置: | 0 |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-ShareDirectoryClient
ShareDirectoryClient オブジェクトは、ファイル/ディレクトリが一覧表示されるベース フォルダーを示しました。
パラメーターのプロパティ
パラメーター セット
Directory
配置: | 0 |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-ShareName
ファイル共有の名前を指定します。
このコマンドレットは、このパラメーターが指定するファイル共有からファイルまたはディレクトリを取得します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
ShareName
配置: | 0 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力