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

Update-AzStorageFileServiceProperty

模块:

Az.Storage

修改 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-AzStorageFileServiceProperty 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 多通道，仅在高级 FileStorage 帐户上受支持。

示例 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 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CorsRule

指定文件服务的 CORS 规则。

类型:	PSCorsRule[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableShareDeleteRetentionPolicy

通过将存储帐户的共享删除保留策略设置为$true，通过设置为 $false 禁用共享删除保留策略。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableSmbMultichannel

通过将多通道设置为$true启用多通道，按设置为$false禁用多通道。 仅适用于高级 FileStorage。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

资源组名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ResourceId

输入存储帐户资源 ID 或文件服务属性资源 ID。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ShareRetentionDays

设置共享 DeleteRetentionPolicy 的保留天数。 仅当启用共享删除保留策略时，才应设置该值。

类型:	Int32
别名:	Days, RetentionDays
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SmbAuthenticationMethod

获取或设置服务器支持的 SMB 身份验证方法。 有效值为 NTLMv2、Kerberos。

类型:	String[]
接受的值:	Kerberos, NTLMv2
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SmbChannelEncryption

获取或设置服务器支持的 SMB 通道加密。 有效值为 AES-128-CCM、AES-128-GCM、AES-256-GCM。

类型:	String[]
接受的值:	AES-128-CCM, AES-128-GCM, AES-256-GCM
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SmbKerberosTicketEncryption

获取或设置服务器支持的 kerberos 票证加密。 有效值为 RC4-HMAC、AES-256。

类型:	String[]
接受的值:	AES-256, RC4-HMAC
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SmbProtocolVersion

获取或设置服务器支持的 SMB 协议版本。 有效值为 SMB2.1、SMB3.0、SMB3.1.1。

类型:	String[]
接受的值:	SMB2.1, SMB3.0, SMB3.1.1
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StorageAccount

存储帐户对象

类型:	PSStorageAccount
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-StorageAccountName

存储帐户名称。

类型:	String
别名:	AccountName, Name
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

PSStorageAccount

String

输出

PSFileServiceProperties