你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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

相关链接

• New-Az存储Share
• Remove-Az存储Share