你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Update-AzStorageFileServiceProperty
修改Azure 存储文件服务的服务属性。
语法
Update-AzStorageFileServiceProperty
[-ResourceGroupName] <String>
[-StorageAccountName] <String>
[-EnableShareDeleteRetentionPolicy <Boolean>]
[-ShareRetentionDays <Int32>]
[-EnableSmbMultichannel <Boolean>]
[-SmbProtocolVersion <String[]>]
[-SmbAuthenticationMethod <String[]>]
[-SmbChannelEncryption <String[]>]
[-SmbKerberosTicketEncryption <String[]>]
[-CorsRule <PSCorsRule[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzStorageFileServiceProperty
-StorageAccount <PSStorageAccount>
[-EnableShareDeleteRetentionPolicy <Boolean>]
[-ShareRetentionDays <Int32>]
[-EnableSmbMultichannel <Boolean>]
[-SmbProtocolVersion <String[]>]
[-SmbAuthenticationMethod <String[]>]
[-SmbChannelEncryption <String[]>]
[-SmbKerberosTicketEncryption <String[]>]
[-CorsRule <PSCorsRule[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzStorageFileServiceProperty
[-ResourceId] <String>
[-EnableShareDeleteRetentionPolicy <Boolean>]
[-ShareRetentionDays <Int32>]
[-EnableSmbMultichannel <Boolean>]
[-SmbProtocolVersion <String[]>]
[-SmbAuthenticationMethod <String[]>]
[-SmbChannelEncryption <String[]>]
[-SmbKerberosTicketEncryption <String[]>]
[-CorsRule <PSCorsRule[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Update-Az存储FileServiceProperty cmdlet 修改Azure 存储文件服务的服务属性。
示例
示例 1:启用文件共享软删除
Update-AzStorageFileServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -EnableShareDeleteRetentionPolicy $true -ShareRetentionDays 5
StorageAccountName : mystorageaccount
ResourceGroupName : myresourcegroup
ShareDeleteRetentionPolicy.Enabled : True
ShareDeleteRetentionPolicy.Days : 5
ProtocolSettings.Smb.Multichannel.Enabled : False
ProtocolSettings.Smb.Versions :
ProtocolSettings.Smb.AuthenticationMethods :
ProtocolSettings.Smb.KerberosTicketEncryption :
ProtocolSettings.Smb.ChannelEncryption :
此命令启用文件共享软删除,保留天数为 5
示例 2:启用 Smb 多通道
Update-AzStorageFileServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -EnableSmbMultichannel $true
StorageAccountName : mystorageaccount
ResourceGroupName : myresourcegroup
ShareDeleteRetentionPolicy.Enabled : True
ShareDeleteRetentionPolicy.Days : 5
ProtocolSettings.Smb.Multichannel.Enabled : True
ProtocolSettings.Smb.Versions :
ProtocolSettings.Smb.AuthenticationMethods :
ProtocolSettings.Smb.KerberosTicketEncryption :
ProtocolSettings.Smb.ChannelEncryption :
此命令启用 Smb 多通道,仅在 高级版 File存储 帐户上受支持。
示例 3:汇报安全 smb 设置
Update-AzStorageFileServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" `
-SMBProtocolVersion SMB2.1,SMB3.0,SMB3.1.1 `
-SMBAuthenticationMethod Kerberos,NTLMv2 `
-SMBKerberosTicketEncryption RC4-HMAC,AES-256 `
-SMBChannelEncryption AES-128-CCM,AES-128-GCM,AES-256-GCM
StorageAccountName : mystorageaccount
ResourceGroupName : myresourcegroup
ShareDeleteRetentionPolicy.Enabled : True
ShareDeleteRetentionPolicy.Days : 5
ProtocolSettings.Smb.Multichannel.Enabled : True
ProtocolSettings.Smb.Versions : {SMB2.1, SMB3.0, SMB3.1.1}
ProtocolSettings.Smb.AuthenticationMethods : {Kerberos, NTLMv2}
ProtocolSettings.Smb.KerberosTicketEncryption : {RC4-HMAC, AES-256}
ProtocolSettings.Smb.ChannelEncryption : {AES-128-CCM, AES-128-GCM, AES-256-GCM}
此命令更新安全 smb 设置。
示例 4:清除安全 Smb 设置
Update-AzStorageFileServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" `
-SMBProtocolVersion @() `
-SMBAuthenticationMethod @() `
-SMBKerberosTicketEncryption @() `
-SMBChannelEncryption @()
StorageAccountName : mystorageaccount
ResourceGroupName : myresourcegroup
ShareDeleteRetentionPolicy.Enabled : True
ShareDeleteRetentionPolicy.Days : 5
ProtocolSettings.Smb.Multichannel.Enabled : True
ProtocolSettings.Smb.Versions :
ProtocolSettings.Smb.AuthenticationMethods :
ProtocolSettings.Smb.KerberosTicketEncryption :
ProtocolSettings.Smb.ChannelEncryption :
此命令清除安全 smb 设置。
示例 5:更新 CORS 规则
$CorsRules = (@{
AllowedHeaders=@("x-ms-blob-content-type","x-ms-blob-content-disposition");
ExposedHeaders=@();
AllowedOrigins=@("*");
AllowedMethods=@("TRACE","CONNECT")},
@{
AllowedOrigins=@("http://www.fabrikam.com","http://www.contoso.com");
ExposedHeaders=@("x-ms-meta-data*","x-ms-meta-customheader");
AllowedHeaders=@("x-ms-meta-target*","x-ms-meta-customheader");
MaxAgeInSeconds=30;
AllowedMethods=@("PUT")})
$property = Update-AzStorageFileServiceProperty -ResourceGroupName myresourcegroup -StorageAccountName mystorageaccount -CorsRule $CorsRules
$property.Cors.CorsRulesProperty
AllowedOrigins : {*}
AllowedMethods : {TRACE, CONNECT}
MaxAgeInSeconds : 0
ExposedHeaders : {}
AllowedHeaders : {x-ms-blob-content-type, x-ms-blob-content-disposition}
AllowedOrigins : {http://www.fabrikam.com, http://www.contoso.com}
AllowedMethods : {PUT}
MaxAgeInSeconds : 30
ExposedHeaders : {x-ms-meta-customheader, x-ms-meta-data*}
AllowedHeaders : {x-ms-meta-customheader, x-ms-meta-target*}
第一个命令将规则数组分配给$CorsRules变量。 此命令使用此代码块中的多行的标准扩展。 第二个命令将$CorsRules中的规则设置为存储帐户的文件服务。
示例 6:清理 CORS 规则
Update-AzStorageFileServiceProperty -ResourceGroupName myresourcegroup -StorageAccountName mystorageaccount -CorsRule @()
此命令通过将 @() 输入到参数 CorsRule 来清理存储帐户的 CORS 规则。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CorsRule
指定文件服务的 CORS 规则。
Type: | PSCorsRule[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableShareDeleteRetentionPolicy
通过将存储帐户的共享删除保留策略设置为$true,通过设置为 $false 禁用共享删除保留策略。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableSmbMultichannel
通过将多通道设置为$true启用多通道,按设置为$false禁用多通道。 仅适用于高级版文件存储。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
资源组名称。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceId
输入存储帐户资源 ID 或文件服务属性资源 ID。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareRetentionDays
设置共享 DeleteRetentionPolicy 的保留天数。 仅当启用共享删除保留策略时,才应设置该值。
Type: | Int32 |
Aliases: | Days, RetentionDays |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SmbAuthenticationMethod
获取或设置服务器支持的 SMB 身份验证方法。 有效值为 NTLMv2、Kerberos。
Type: | String[] |
Accepted values: | Kerberos, NTLMv2 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SmbChannelEncryption
获取或设置服务器支持的 SMB 通道加密。 有效值为 AES-128-CCM、AES-128-GCM、AES-256-GCM。
Type: | String[] |
Accepted values: | AES-128-CCM, AES-128-GCM, AES-256-GCM |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SmbKerberosTicketEncryption
获取或设置服务器支持的 kerberos 票证加密。 有效值为 RC4-HMAC、AES-256。
Type: | String[] |
Accepted values: | AES-256, RC4-HMAC |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SmbProtocolVersion
获取或设置服务器支持的 SMB 协议版本。 有效值为 SMB2.1、SMB3.0、SMB3.1.1。
Type: | String[] |
Accepted values: | SMB2.1, SMB3.0, SMB3.1.1 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StorageAccount
存储 帐户对象
Type: | PSStorageAccount |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountName
存储帐户名称。
Type: | String |
Aliases: | AccountName, Name |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
输出
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈