Update-AzStorageFileServiceProperty

Modifie les propriétés du service pour le service de fichiers Stockage 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

L’applet de commande Update-Az Stockage FileServiceProperty modifie les propriétés du service pour le service de fichiers Stockage Azure.

Exemples

Exemple 1 : Activer la suppression réversible du partage de fichiers

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        :

Cette commande active la suppression réversible du partage de fichiers avec les jours de rétention sous la forme 5

Exemple 2 : Activer 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        :

Cette commande active Smb Multichannel, prise en charge uniquement sur le compte Premium File Stockage.

Exemple 3 : Mises à jour paramètres smb sécurisés

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}

Cette commande met à jour les paramètres smb sécurisés.

Exemple 4 : Effacer les paramètres smb sécurisés

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        :

Cette commande efface les paramètres smb sécurisés.

Exemple 5 : Mettre à jour les règles 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*}

La première commande affecte un tableau de règles à la variable $CorsRules. Cette commande utilise des étendues standard sur plusieurs lignes dans ce bloc de code. La deuxième commande définit les règles de $CorsRules au service de fichiers d’un compte Stockage.

Exemple 6 : Nettoyer les règles CORS

Update-AzStorageFileServiceProperty -ResourceGroupName myresourcegroup -StorageAccountName mystorageaccount -CorsRule @()

Cette commande propre les règles CORS d’un compte Stockage en plaçant @() dans le paramètre CorsRule.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CorsRule

Spécifie les règles CORS pour le service de fichiers.

Type:PSCorsRule[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableShareDeleteRetentionPolicy

Activez la stratégie de suppression de partage pour le compte de stockage en définissant sur $true, désactivez la stratégie de suppression de partage en définissant sur $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableSmbMultichannel

Activez Multichannel en définissant sur $true, désactivez Multichannel en définissant sur $false. S’applique uniquement au fichier Premium Stockage.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Nom du groupe de ressources.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

Entrez un id de ressource de compte Stockage ou un ID de ressource de service de fichiers.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareRetentionDays

Définit le nombre de jours de rétention pour le partage DeleteRetentionPolicy. La valeur doit être définie uniquement lors de l’activation de la stratégie de suppression de la rétention du partage.

Type:Int32
Aliases:Days, RetentionDays
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SmbAuthenticationMethod

Obtient ou définit des méthodes d’authentification S Mo prises en charge par le serveur. Les valeurs valides sont NTLMv2, Kerberos.

Type:String[]
Accepted values:Kerberos, NTLMv2
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SmbChannelEncryption

Obtient ou définit le chiffrement de canal S Mo pris en charge par le serveur. Les valeurs valides sont 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

Obtient ou définit le chiffrement de ticket Kerberos pris en charge par le serveur. Les valeurs valides sont 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

Obtient ou définit les versions de protocole S Mo prises en charge par le serveur. Les valeurs valides sont S Mo 2.1, S Mo 3.0, S Mo 3.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

objet de compte Stockage

Type:PSStorageAccount
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountName

Stockage Nom du compte.

Type:String
Aliases:AccountName, Name
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

PSStorageAccount

String

Sorties

PSFileServiceProperties