Get-AzStorageFile

  • リファレンス
モジュール:
Az.Storage

パスのディレクトリとファイルを一覧表示します。

構文

Get-AzStorageFile
   [-ShareName] <String>
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageFile
   [-Share] <CloudFileShare>
   [-ShareClient <ShareClient>]
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageFile
   [-Directory] <CloudFileDirectory>
   [-ShareDirectoryClient <ShareDirectoryClient>]
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

説明

Get-AzStorageFile コマンドレットは、指定した共有またはディレクトリのディレクトリとファイルを一覧表示します。 Path パラメーターを指定して、指定したパス内のディレクトリまたはファイルのインスタンスを取得します。 このコマンドレットは、 AzureStorageFile オブジェクトと AzureStorageDirectory オブジェクトを 返します。 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 コマンドレットにパイプライン処理してディレクトリを一覧表示します。

パラメーター

-ClientTimeoutPerRequest

1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。 指定した時間内に前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。 間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

同時ネットワーク呼び出しの最大数を指定します。 このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。 指定した値は絶対カウントであり、コア数には乗算されません。 このパラメーターは、1 秒あたり 100 キロビットなどの低帯域幅環境でのネットワーク接続の問題を軽減するのに役立ちます。 既定値は 10 です。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Azure Storage コンテキストを指定します。 ストレージ コンテキストを取得するには、New-AzStorageContext コマンドレットを使用します。

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

フォルダーを CloudFileDirectory オブジェクトとして指定します。 このコマンドレットは、このパラメーターが指定するフォルダーを取得します。 ディレクトリを取得するには、New-AzStorageDirectory コマンドレットを使用します。 Get-AzStorageFile コマンドレットを使用してディレクトリを取得することもできます。

Type:CloudFileDirectory
Aliases:CloudFileDirectory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DisAllowTrailingDot

末尾のドット (.) をディレクトリ名とファイル名にサフィックス付けしないようにします。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeExtendedInfo

タイムスタンプ、ETag、属性、permissionKey などの拡張ファイル情報をリスト ファイルやディレクトリに含めないでください。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

フォルダーのパスを指定します。 Path パラメーターを省略すると、指定したファイル共有またはディレクトリ内のディレクトリとファイルが Get-AzStorageFile に一覧表示されます。 Path パラメーターを含める場合、Get-AzStorageFile は指定されたパス内のディレクトリまたはファイルのインスタンスを返します。

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

要求のサービス側タイムアウト間隔を秒単位で指定します。 サービスが要求を処理する前に指定した間隔が経過すると、Storage サービスはエラーを返します。

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Share

CloudFileShare オブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するファイル共有からファイルまたはディレクトリを取得します。 CloudFileShare オブジェクトを取得するには、Get-AzStorageShare コマンドレットを使用します。 このオブジェクトには、Storage コンテキストが含まれています。 このパラメーターを指定する場合は、Context パラメーターを指定しないでください。

Type:CloudFileShare
Aliases:CloudFileShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareClient

ShareClient オブジェクトは、ファイル/ディレクトリが一覧表示される共有を示しました。

Type:ShareClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareDirectoryClient

ShareDirectoryClient オブジェクトは、ファイル/ディレクトリが一覧表示されるベース フォルダーを示しました。

Type:ShareDirectoryClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareName

ファイル共有の名前を指定します。 このコマンドレットは、このパラメーターが指定するファイル共有からファイルまたはディレクトリを取得します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

入力

CloudFileShare

CloudFileDirectory

IStorageContext

出力

AzureStorageFile