Update-AzStorageFileServiceProperty
Modifica as propriedades de serviço para o serviço Arquivo de Armazenamento do Azure.
Syntax
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>]
Description
O cmdlet Update-AzStorageFileServiceProperty modifica as propriedades de serviço para o serviço Arquivo de Armazenamento do Azure.
Exemplos
Exemplo 1: Habilitar compartilhamento de arquivos softdelete
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 :
Este comando habilita o compartilhamento de arquivos softdelete delete com dias de retenção como 5
Exemplo 2: Habilitar Smb Multichannel
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 :
Este comando habilita o Smb Multichannel, suportado apenas na conta Premium FileStorage.
Exemplo 3: Atualiza configurações seguras de 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}
Este comando atualiza as configurações seguras do smb.
Exemplo 4: Limpar configurações smb seguras
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 :
Este comando limpa as configurações seguras do smb.
Exemplo 5: Atualizar regras 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*}
O primeiro comando atribui uma matriz de regras à variável $CorsRules. Este comando usa extensões padrão em várias linhas neste bloco de código. O segundo comando define as regras em $CorsRules ao serviço Arquivo de uma conta de armazenamento.
Exemplo 6: Limpar regras CORS
Update-AzStorageFileServiceProperty -ResourceGroupName myresourcegroup -StorageAccountName mystorageaccount -CorsRule @()
Esse comando limpa as regras CORS de uma conta de armazenamento inserindo @() no parâmetro CorsRule.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CorsRule
Especifica regras CORS para o serviço Arquivo.
Type: | PSCorsRule[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableShareDeleteRetentionPolicy
Habilite a Política de Retenção de Exclusão de compartilhamento para a conta de armazenamento definindo como $true, desabilite a Política de Exclusão de Retenção de compartilhamento definindo como $false.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableSmbMultichannel
Habilite Multichannel definindo como $true, desative Multichannel definindo como $false. Aplica-se somente ao Premium FileStorage.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Nome do grupo de recursos.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceId
Insira uma ID de recurso de conta de armazenamento ou uma ID de recurso de propriedades de serviço de arquivo.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareRetentionDays
Define o número de dias de retenção para o compartilhamento DeleteRetentionPolicy. O valor só deve ser definido quando habilitar o compartilhamento Excluir Política de Retenção.
Type: | Int32 |
Aliases: | Days, RetentionDays |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SmbAuthenticationMethod
Obtém ou define métodos de autenticação SMB suportados pelo servidor. Os valores válidos são NTLMv2, Kerberos.
Type: | String[] |
Accepted values: | Kerberos, NTLMv2 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SmbChannelEncryption
Obtém ou define a criptografia de canal SMB suportada pelo servidor. Os valores válidos são 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
Obtém ou define a criptografia de tíquete kerberos suportada pelo servidor. Os valores válidos são 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
Obtém ou define versões de protocolo SMB suportadas pelo servidor. Os valores válidos são 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
Objeto de conta de armazenamento
Type: | PSStorageAccount |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountName
Nome da conta de armazenamento.
Type: | String |
Aliases: | AccountName, Name |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Saídas
Azure PowerShell
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de