Get-AzStorageShare

  • 參考
模組:
Az.Storage

取得檔案共享的清單。

Syntax

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>]

Description

Get-Az 儲存體 Share Cmdlet 會取得記憶體帳戶的檔案共享清單。

範例

範例 1：取得檔案共用

Get-AzStorageShare -Name "ContosoShare06"

此命令會取得名為 ContosoShare06 的檔案共用。

範例 2：取得以字串開頭的所有檔案共用

Get-AzStorageShare -Prefix "Contoso"

此命令會取得名稱開頭為 Contoso 的所有檔案共用。

範例 3：取得指定內容中的所有檔案共用

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

第一個命令會使用 New-Az 儲存體 Context Cmdlet，使用 Local 參數建立內容，然後將該內容物件儲存在 $Context 變數中。 第二個命令會取得儲存在 $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 驗證取得共用屬性。 使用 OAuth 驗證取得共用屬性將會失敗，因為 API 不支援 OAuth。 因此，若要使用 OAuth 驗證取得共用物件，必須略過擷取共用屬性。

參數

-ClientTimeoutPerRequest

指定一個服務要求的用戶端超時時間間隔，以秒為單位。 如果先前的呼叫在指定的間隔內失敗，此 Cmdlet 會重試要求。 如果此 Cmdlet 在間隔經過之前未收到成功的回應，此 Cmdlet 會傳回錯誤。

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

-ConcurrentTaskCount

指定並行網路呼叫上限。 您可以藉由指定並行網路呼叫數目上限，使用此參數來限制並行 CPU 和頻寬使用量的並行存取。 指定的值是絕對計數，不會乘以核心計數。 此參數可協助減少低頻寬環境中的網路連線問題，例如每秒 100 千位。 預設值為 10。

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

-Context

指定 Azure 儲存體 內容。 若要取得內容，請使用 New-Az 儲存體 Context Cmdlet。

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

-IncludeDeleted

包含已刪除的共享，根據預設，取得共用不會包含已刪除的共用

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

-Name

指定檔案共享的名稱。 這個 Cmdlet 會取得此參數所指定的檔案共用，或者如果您指定不存在的檔案共享名稱，則不會有任何專案。

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

-Prefix

指定檔案共用的前置詞。 此 Cmdlet 會取得符合此參數所指定前置詞的檔案共用，如果沒有檔案共用符合指定的前置詞，則不會共用檔案共用。

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

-ServerTimeoutPerRequest

指定要求的伺服器部分逾時期間長度。

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

-SkipGetProperty

指定此參數只產生本機共享物件，而不需要從伺服器取得共享屬性。

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

-SnapshotTime

要接收之檔案共用快照集的 SnapshotTime。

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

輸入

IStorageContext

輸出

AzureStorageFileShare