New-AzRmStorageShare

  • Referencia
Módulo:
Az.Storage

Crea un recurso compartido de archivos de almacenamiento.

Sintaxis

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

Description

El cmdlet New-AzRmStorageShare crea un recurso compartido de archivos de Storage.

Ejemplos

Ejemplo 1: Crear un recurso compartido de archivos de almacenamiento con el nombre de la cuenta de almacenamiento y el nombre del recurso compartido, con metadatos y cuota de recursos compartidos como 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

Este comando crea un recurso compartido de archivos de almacenamiento con metadatos y cuota de recursos compartidos como 100 GiB.

Ejemplo 2: Creación de un recurso compartido de archivos de almacenamiento con el objeto de cuenta de almacenamiento

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Este comando crea un recurso compartido de archivos de almacenamiento con el objeto de cuenta de Almacenamiento y el nombre del recurso compartido.

Ejemplo 3: Creación de un recurso compartido de archivos de almacenamiento con accesstier como frecuente

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

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Este comando crea un recurso compartido de archivos de storage con accesstier como Frecuente.

Ejemplo 4: Creación de una instantánea de recurso compartido de archivos de almacenamiento de un recurso compartido existente

$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

Este comando crea una instantánea de recurso compartido de archivos de almacenamiento de un recurso compartido de archivos base existente.

Ejemplo 5: Crear un recurso compartido de archivos de almacenamiento con EnabledProtocol proeprty como NFS y la propiedad RootSquash como 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

Este comando crea un recurso compartido de archivos de storage con EnabledProtocol proeprty como NFS y RootSquash como NoRootSquash.

Parámetros

-AccessTier

Nivel de acceso para un recurso compartido específico. La cuenta de StorageV2 puede elegir entre TransactionOptimized (valor predeterminado), Frecuente y Esporádico. La cuenta FileStorage puede elegir Premium.

Tipo:String
Valores aceptados:TransactionOptimized, Premium, Hot, Cool
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnabledProtocol

Establece protocolos para recursos compartidos de archivos. No se puede cambiar después de la creación del recurso compartido de archivos. Los valores posibles son: 'SMB', 'NFS'

Tipo:String
Valores aceptados:NFS, SMB
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Metadata

Compartir metadatos

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Nombre del recurso compartido de archivos de Azure

Tipo:String
Alias:N, ShareName
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-QuotaGiB

Cuota de acciones en Gibibyte.

Tipo:Int32
Alias:Quota
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

Nombre del grupo de recursos.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RootSquash

Establece la reducción de los derechos de acceso para el superusuario remoto. Los valores posibles son: 'NoRootSquash', 'RootSquash', 'AllSquash'

Tipo:String
Valores aceptados:NoRootSquash, RootSquash, AllSquash
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Snapshot

Cree una instantánea del recurso compartido existente con el mismo nombre.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-StorageAccount

Objeto de cuenta de almacenamiento

Tipo:PSStorageAccount
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageAccountName

Nombre de la cuenta de almacenamiento.

Tipo:String
Alias:AccountName
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

PSStorageAccount

Salidas

PSShare