Condividi tramite

Update-AzRmStorageShare

  • Riferimento
Modulo:
Az.Storage

Modifica una condivisione file di archiviazione.

Sintassi

Update-AzRmStorageShare
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      -Name <String>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzRmStorageShare
      [-ResourceId] <String>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzRmStorageShare
      -InputObject <PSShare>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet New-AzRmStorageShare modifica una condivisione file di archiviazione.

Esempio

Esempio 1: modifica i metadati di una condivisione file di archiviazione e la quota di condivisione con il nome dell'account di archiviazione e il nome della condivisione

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -QuotaGiB 200 -Metadata @{tag0="value0";tag1="value1"}

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  200

$share.Metadata

Key  Value  
---  ----- 
tag0 value0
tag1 value1

Questo comando modifica i metadati e la quota di condivisione di una condivisione file di archiviazione con il nome e il nome della condivisione dell'account di archiviazione e mostra il risultato della modifica con l'oggetto condivisione file restituito.

Esempio 2: Modifica i metadati in una condivisione file di archiviazione con l'oggetto account di archiviazione e il nome della condivisione

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount"
$share = Update-AzRmStorageShare -StorageAccount $accountObject -Name "myshare" -Metadata @{tag0="value0";tag1="value1"}

Questo comando modifica i metadati in una condivisione file di archiviazione con l'oggetto account di archiviazione e il nome della condivisione.

Esempio 3: Modifica la quota di condivisione per tutte le condivisioni file di archiviazione in un account di archiviazione con pipeline

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | Update-AzRmStorageShare -QuotaGiB 5000

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
share1   5000
share2   5000

Questo comando modifica la quota di condivisione come 5000 GiB per tutte le condivisioni file di archiviazione in un account di archiviazione con pipeline.

Esempio 4: Modificare una condivisione file di archiviazione con accesstier come sporadico

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Cool

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare                            Cool

Questo comando modifica una condivisione file di archiviazione con accesstier come sporadico.

Esempio 5: Modifica rootquash per le condivisioni file in un account di archiviazione

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -RootSquash NoRootSquash 

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  

$share.RootSquash
NoRootSquash

Questo comando modifica la proprietà RootSquash di condivisione in NoRootSquash. La proprietà RootSquash è solo avaialbe in condivisione con EnabledProtocol come NFS.

Esempio 6: modifica una condivisione file di archiviazione con larghezza di banda di provisioning e operazioni di I/O al secondo

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -ProvisionedBandwidthMibps 129 -ProvisionedIops 3032

Questo comando modifica una condivisione file di archiviazione con larghezza di banda di cui è stato effettuato il provisioning e le operazioni di I/O al secondo, funziona solo nel tipo di account File di cui è stato effettuato il provisioning v2.

Esempio 7: modifica una condivisione file di archiviazione con larghezza di banda con bursting a pagamento e operazioni di I/O al secondo

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -PaidBurstingEnabled -PaidBurstingMaxBandwidthMibps 129 -PaidBurstingMaxIops 3032

Questo comando modifica una condivisione file di archiviazione con larghezza di banda con bursting a pagamento e operazioni di I/O al secondo, funziona solo sul tipo di account File di cui è stato effettuato il provisioning v1.

Parametri

-AccessTier

Livello di accesso per una condivisione specifica. L'account StorageV2 può scegliere tra TransactionOptimized (impostazione predefinita), Accesso frequente e Sporadico. L'account FileStorage può scegliere Premium.

Tipo:String
Valori accettati:TransactionOptimized, Premium, Hot, Cool
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Oggetto Condivisione di archiviazione

Tipo:PSShare
Alias:Share
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Metadata

Condividi metadati

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Nome condivisione

Tipo:String
Alias:N, ShareName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PaidBurstingEnabled

Indica se il bursting a pagamento è abilitato per la condivisione. Questa proprietà è solo per le condivisioni file create in File con provisioning v1 tipo di account SSD.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PaidBurstingMaxBandwidthMibps

Larghezza di banda massima di bursting a pagamento per la condivisione, in mebibyte al secondo. Questa proprietà è solo per le condivisioni file create in File con provisioning v1 tipo di account SSD. Il valore massimo consentito è 10340, ovvero la larghezza di banda massima consentita per una condivisione.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PaidBurstingMaxIops

Numero massimo di operazioni di I/O al secondo a pagamento per la condivisione. Questa proprietà è solo per le condivisioni file create in File con provisioning v1 tipo di account SSD. Il valore massimo consentito è 102400, ovvero il numero massimo di operazioni di I/O al secondo consentite per una condivisione.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProvisionedBandwidthMibps

Larghezza di banda di cui è stato effettuato il provisioning, in mebibyte al secondo. Questa proprietà è solo per le condivisioni file create in Tipo di account File con provisioning v2. Fare riferimento all'output del cmdlet Get-AzStorageFileServiceUsage per il valore minimo e massimo consentito per la larghezza di banda di cui è stato effettuato il provisioning.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProvisionedIops

Operazioni di I/O al secondo di cui è stato effettuato il provisioning della condivisione. Questa proprietà è solo per le condivisioni file create in Tipo di account File con provisioning v2. Fare riferimento all'output del cmdlet Get-AzStorageFileServiceUsage per il valore minimo e massimo consentito per le operazioni di I/O al secondo di cui è stato effettuato il provisioning.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-QuotaGiB

Quota di condivisione in Gibibyte.

Tipo:Int32
Alias:Quota
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

Nome gruppo di risorse.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceId

Immettere un ID risorsa condivisione file.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RootSquash

Imposta la riduzione dei diritti di accesso per l'utente con privilegi avanzati remoti. I valori possibili includono: 'NoRootSquash', 'RootSquash', 'AllSquash'

Tipo:String
Valori accettati:NoRootSquash, RootSquash, AllSquash
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StorageAccount

Oggetto account di archiviazione

Tipo:PSStorageAccount
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-StorageAccountName

Nome account di archiviazione.

Tipo:String
Alias:AccountName
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Output