次の方法で共有

Get-AzStorageShare

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

ファイル共有の一覧を取得します。

構文

Get-AzStorageShare
   [[-Prefix] <String>]
   [-IncludeDeleted]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageShare
   [-Name] <String>
   [[-SnapshotTime] <DateTimeOffset>]
   [-SkipGetProperty]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

説明

Get-AzStorageShare コマンドレットは、ストレージ アカウントのファイル共有の一覧を取得します。

例

例 1: ファイル共有を取得する

Get-AzStorageShare -Name "ContosoShare06"

このコマンドは、ContosoShare06 という名前のファイル共有を取得します。

例 2: 文字列で始まるすべてのファイル共有を取得する

Get-AzStorageShare -Prefix "Contoso"

このコマンドは、Contoso で始まる名前を持つすべてのファイル共有を取得します。

例 3: 指定したコンテキスト内のすべてのファイル共有を取得する

$Context = New-AzStorageContext -Local
Get-AzStorageShare -Context $Context

最初のコマンドでは、 New-AzStorageContext コマンドレットを使用して、 Local パラメーターを使用してコンテキストを作成し、そのコンテキスト オブジェクトを$Context変数に格納します。 2 番目のコマンドは、$Contextに格納されているコンテキスト オブジェクトのファイル共有を取得します。

例 4: 特定の共有名と SnapshotTime を使用してファイル共有スナップショットを取得する

Get-AzStorageShare -Name "ContosoShare06" -SnapshotTime "6/16/2017 9:48:41 AM +00:00"

このコマンドは、特定の共有名と SnapshotTime を持つファイル共有スナップショットを取得します。

例 5: OAuth 認証を使用して、共有プロパティをフェッチせずにファイル共有オブジェクトを取得する。

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent
$share = Get-AzStorageShare -Name "ContosoShare06" -SkipGetProperty -Context $ctx

このコマンドは、OAuth 認証で共有プロパティを取得せずにファイル共有スナップショットを取得します。 API が OAuth をサポートしていないため、OAuth 認証を使用した共有プロパティの取得は失敗します。 そのため、OAuth 認証で共有オブジェクトを取得するには、フェッチ共有プロパティをスキップする必要があります。

パラメーター

-ClientTimeoutPerRequest

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

型:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ConcurrentTaskCount

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

型:Nullable<T>[Int32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Context

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

型:IStorageContext
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IncludeDeleted

削除された共有を含める。既定では、共有の取得には削除された共有は含まれません

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

ファイル共有の名前を指定します。 このコマンドレットは、このパラメーターが指定するファイル共有を取得します。存在しないファイル共有の名前を指定した場合は何も取得しません。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Prefix

ファイル共有のプレフィックスを指定します。 このコマンドレットは、このパラメーターが指定したプレフィックスと一致するファイル共有を取得します。指定したプレフィックスと一致するファイル共有がない場合はファイル共有を取得します。

型:String
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServerTimeoutPerRequest

要求のサーバー部分のタイムアウト期間の長さを指定します。

型:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SkipGetProperty

サーバーから共有プロパティを取得せずにローカル共有オブジェクトのみを生成するには、このパラメーターを指定します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SnapshotTime

受信するファイル共有スナップショットの SnapshotTime。

型:Nullable<T>[DateTimeOffset]
配置:1
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

IStorageContext

出力

AzureStorageFileShare