Condividi tramite

New-AzRmStorageShare

  • Riferimento
Modulo:
Az.Storage

Crea una condivisione file di archiviazione.

Sintassi

New-AzRmStorageShare
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   -Name <String>
   [-QuotaGiB <Int32>]
   [-Metadata <Hashtable>]
   [-AccessTier <String>]
   [-Snapshot]
   [-EnabledProtocol <String>]
   [-RootSquash <String>]
   [-ProvisionedBandwidthMibps <Int32>]
   [-ProvisionedIops <Int32>]
   [-PaidBurstingEnabled]
   [-PaidBurstingMaxIops <Int32>]
   [-PaidBurstingMaxBandwidthMibps <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzRmStorageShare
   -StorageAccount <PSStorageAccount>
   -Name <String>
   [-QuotaGiB <Int32>]
   [-Metadata <Hashtable>]
   [-AccessTier <String>]
   [-Snapshot]
   [-EnabledProtocol <String>]
   [-RootSquash <String>]
   [-ProvisionedBandwidthMibps <Int32>]
   [-ProvisionedIops <Int32>]
   [-PaidBurstingEnabled]
   [-PaidBurstingMaxIops <Int32>]
   [-PaidBurstingMaxBandwidthMibps <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

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

Esempio

Esempio 1: Creare una condivisione file di archiviazione con il nome dell'account di archiviazione e il nome della condivisione, con metadati e quota di condivisione come 100 GiB.

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -QuotaGiB 100 -Metadata @{"tag1" = "value1"; "tag2" = "value2" }

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Questo comando crea una condivisione file di archiviazione con metadati e quota di condivisione come 100 GiB.

Esempio 2: Creare una condivisione file di archiviazione con l'oggetto account di archiviazione

Get-AzStorageAccount -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | New-AzRmStorageShare -Name "myshare"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Questo comando crea una condivisione file di archiviazione con l'oggetto account di archiviazione e il nome della condivisione.

Esempio 3: Creare una condivisione file di archiviazione con accesstier come accesso frequente

$share = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Hot

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Questo comando crea una condivisione file di archiviazione con accesstier come accesso frequente.

Esempio 4: Creare uno snapshot di condivisione file di archiviazione di una condivisione esistente

$shareSnapshot = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -Snapshot

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes snapshotTime 
----     -------- ---------------- ---------- ------- ------- --------------- ------------   
myshare                                                                       2021-05-10T08:04:08

Questo comando crea uno snapshot di condivisione file di archiviazione di una condivisione file di base esistente.

Esempio 5: Creare una condivisione file di archiviazione con EnabledProtocol proeprty come NFS e la proprietà RootSquash come NoRootSquash

$share = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -EnabledProtocol NFS -RootSquash NoRootSquash 

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

$share.RootSquash
NoRootSquash

Questo comando crea una condivisione file di archiviazione con EnabledProtocol proeprty come NFS e RootSquash proeprty come NoRootSquash.

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

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

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

Esempio 7: Creare 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 crea una condivisione file di archiviazione con larghezza di banda con burst 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

-EnabledProtocol

Imposta i protocolli per le condivisioni file. Non può essere modificato dopo la creazione della condivisione file. I valori possibili includono: 'SMB', 'NFS'

Tipo:String
Valori accettati:NFS, SMB
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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 file di Azure

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:SwitchParameter
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

-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

-Snapshot

Creare uno snapshot della condivisione esistente con lo stesso nome.

Tipo:SwitchParameter
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