Get-AzStorageShare
语法
MatchingPrefix （默认值）
Get-AzStorageShare
[[-Prefix] <String>]
[-IncludeDeleted]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Specific
Get-AzStorageShare
[-Name] <String>
[[-SnapshotTime] <DateTimeOffset>]
[-SkipGetProperty]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
说明
Get-AzStorageShare cmdlet 获取存储帐户的文件共享列表。
示例
示例 1：获取文件共享
Get-AzStorageShare -Name "ContosoShare06"
此命令获取名为 ContosoShare06 的文件共享。
示例 2：获取以字符串开头的所有文件共享
Get-AzStorageShare -Prefix "Contoso"
此命令获取所有以 Contoso 开头的名称的文件共享。
示例 3：获取指定上下文中的所有文件共享
$Context = New-AzStorageContext -Local
Get-AzStorageShare -Context $Context
第一个命令使用 New-AzStorageContext 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 将返回错误。
参数属性
| 类型: | Nullable<T>[Int32]
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | ClientTimeoutPerRequestInSeconds |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConcurrentTaskCount
指定最大并发网络调用数。
可以使用此参数通过指定并发网络调用的最大数目来限制本地 CPU 和带宽使用量的并发性。
指定的值是绝对计数，不乘以核心计数。
此参数可帮助减少低带宽环境中的网络连接问题，例如每秒 100 千比特。
默认值为 10。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Context
指定 Azure 存储上下文。
若要获取上下文，请使用 New-AzStorageContext cmdlet。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IncludeDeleted
包括已删除的共享，默认情况下，获取共享不包括已删除的共享
参数属性
参数集
MatchingPrefix
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
指定文件共享的名称。
此 cmdlet 获取此参数指定的文件共享;如果未指定不存在的文件共享的名称，则不执行任何作。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Specific
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Prefix
指定文件共享的前缀。
此 cmdlet 获取与此参数指定的前缀匹配的文件共享;如果没有与指定前缀匹配的文件共享，则不获取文件共享。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
MatchingPrefix
| Position: | 0 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ServerTimeoutPerRequest
指定请求的服务器部分超时期限的长度。
参数属性
| 类型: | Nullable<T>[Int32]
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | ServerTimeoutPerRequestInSeconds |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SkipGetProperty
指定此参数以仅生成本地共享对象，而不从服务器获取共享属性。
参数属性
参数集
Specific
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SnapshotTime
要接收的文件共享快照的 SnapshotTime。
参数属性
参数集
Specific
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输出
