Compartir a través de

Update-AzStorageFileServiceProperty

Módulo:
Az.Storage Module

Modifica las propiedades del servicio para el servicio Azure Storage File.

Sintaxis

AccountName (valor predeterminado) 

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>]

AccountObject 

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>]

FileServicePropertiesResourceId 

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

El cmdlet Update-AzStorageFileServiceProperty modifica las propiedades de servicio del servicio Azure Storage File.

Ejemplos

Ejemplo 1: Habilitar softdelete del recurso compartido de archivos

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 la eliminación de softdelete del recurso compartido de archivos con días de retención como 5.

Ejemplo 2: Habilitar Smb multicanal

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 Smb multicanal, solo compatible con la cuenta Premium FileStorage.

Ejemplo 3: Actualizaciones de la configuración de smb segura

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 actualiza la configuración de smb segura.

Ejemplo 4: Borrar la configuración de smb segura

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 borra la configuración de smb segura.

Ejemplo 5: Actualización de reglas de 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*}

El primer comando asigna una matriz de reglas a la variable $CorsRules. Este comando usa la extensión estándar en varias líneas de este bloque de código. El segundo comando establece las reglas de $CorsRules en el servicio File de una cuenta de almacenamiento.

Ejemplo 6: Limpieza de reglas de CORS

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

Este comando limpia las reglas de CORS de una cuenta de almacenamiento mediante la entrada de @() en el parámetro CorsRule.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CorsRule

Especifica reglas CORS para el servicio File.

Propiedades de parámetro

Tipo:

PSCorsRule[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EnableShareDeleteRetentionPolicy

Habilite la directiva de retención de eliminación de recursos compartidos para la cuenta de almacenamiento establecida en $true, deshabilite la directiva de retención de eliminación de recursos compartidos establecida en $false.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EnableSmbMultichannel

Habilite Multichannel estableciendo en $true, deshabilite Multichannel estableciendo en $false. Solo se aplica a FileStorage Premium.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceGroupName

Nombre del grupo de recursos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccountName
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceId

Escriba un identificador de recurso de la cuenta de almacenamiento o un identificador de recurso de file service.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FileServicePropertiesResourceId
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ShareRetentionDays

Establece el número de días de retención del recurso compartido DeleteRetentionPolicy. El valor solo debe establecerse al habilitar la directiva de retención de eliminación de recursos compartidos.

Propiedades de parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Días, RetentionDays

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SmbAuthenticationMethod

Obtiene o establece métodos de autenticación SMB admitidos por el servidor. Los valores válidos son NTLMv2, Kerberos.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Valores aceptados:Kerberos, NTLMv2
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SmbChannelEncryption

Obtiene o establece el cifrado de canal SMB admitido por el servidor. Los valores válidos son AES-128-CCM, AES-128-GCM, AES-256-GCM.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Valores aceptados:AES-128-CCM, AES-128-GCM, AES-256-GCM
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SmbKerberosTicketEncryption

Obtiene o establece el cifrado de vales kerberos admitido por el servidor. Los valores válidos son RC4-HMAC, AES-256.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Valores aceptados:AES-256, RC4-HMAC
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SmbProtocolVersion

Obtiene o establece las versiones del protocolo SMB compatibles con el servidor. Los valores válidos son SMB2.1, SMB3.0, SMB3.1.1.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Valores aceptados:SMB2.1, SMB3.0, SMB3.1.1
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-StorageAccount

Objeto de cuenta de almacenamiento

Propiedades de parámetro

Tipo:PSStorageAccount
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccountObject
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-StorageAccountName

Nombre de la cuenta de almacenamiento.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Nombre de la cuenta, Nombre

Conjuntos de parámetros

AccountName
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSStorageAccount

String

Salidas

PSFileServiceProperties