Compartir a través de

New-AzRmStorageContainer

Módulo:
Az.Storage Module

Crea un contenedor de blobs de Storage

Sintaxis

AccountName (valor predeterminado) 

New-AzRmStorageContainer
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    -Name <String>
    [-PublicAccess <PSPublicAccess>]
    [-Metadata <Hashtable>]
    [-RootSquash <String>]
    [-EnableImmutableStorageWithVersioning]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AccountNameEncryptionScope 

New-AzRmStorageContainer
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    -Name <String>
    -DefaultEncryptionScope <String>
    -PreventEncryptionScopeOverride <Boolean>
    [-PublicAccess <PSPublicAccess>]
    [-Metadata <Hashtable>]
    [-RootSquash <String>]
    [-EnableImmutableStorageWithVersioning]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AccountObject 

New-AzRmStorageContainer
    -StorageAccount <PSStorageAccount>
    -Name <String>
    [-PublicAccess <PSPublicAccess>]
    [-Metadata <Hashtable>]
    [-RootSquash <String>]
    [-EnableImmutableStorageWithVersioning]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AccountObjectEncryptionScope 

New-AzRmStorageContainer
    -StorageAccount <PSStorageAccount>
    -Name <String>
    -DefaultEncryptionScope <String>
    -PreventEncryptionScopeOverride <Boolean>
    [-PublicAccess <PSPublicAccess>]
    [-Metadata <Hashtable>]
    [-RootSquash <String>]
    [-EnableImmutableStorageWithVersioning]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet New-AzRmStorageContainer crea un contenedor de blobs de Storage.

Ejemplos

Ejemplo 1: Creación de un contenedor de blobs de Storage con el nombre de la cuenta de almacenamiento y el nombre del contenedor, con metadatos

New-AzRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -ContainerName "myContainer" -Metadata @{tag0="value0";tag1="value1";tag2="value2"}

Este comando crea un contenedor de blobs de Storage con el nombre de la cuenta de almacenamiento y el nombre del contenedor, con metadatos.

Ejemplo 2: Creación de un contenedor de blobs de Storage con el objeto de cuenta de Storage y el nombre del contenedor, con acceso público como Blob

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount"
New-AzRmStorageContainer -StorageAccount $accountObject -ContainerName "myContainer" -PublicAccess Blob

Este comando crea un contenedor de blobs de Storage con el nombre de contenedor y el objeto de cuenta de Storage, con acceso público como Blob.

Ejemplo 3: Creación de un contenedor de almacenamiento con la configuración EncryptionScope

$c = New-AzRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "mystorageaccount" -Name testcontainer -DefaultEncryptionScope "testscope" -PreventEncryptionScopeOverride $true

$c

   ResourceGroupName: myResourceGroup, StorageAccountName: mystorageaccount

Name          PublicAccess LastModified HasLegalHold HasImmutabilityPolicy
----          ------------ ------------ ------------ ---------------------
testcontainer                           False        False

$c.DefaultEncryptionScope
testscope

$c.DenyEncryptionScopeOverride
True

Este comando crea un contenedor de almacenamiento con un encryptionScope predeterminado y bloquea la invalidación del ámbito de cifrado del valor predeterminado del contenedor. A continuación, muestre las propiedades del contenedor relacionadas.

Ejemplo 4: Creación de un contenedor de Azure Storage con RootSquash

$container = New-AzRmStorageContainer -ResourceGroupName "myrsourcegroup" -AccountName "mystorageaccount" -Name "mycontainer" -RootSquash AllSquash

$container.EnableNfsV3AllSquash
True

$container.EnableNfsV3RootSquash
False

Este comando crea un contenedor de almacenamiento, con la propiedad RootSquash establecida como AllSquash. RootSquash solo funciona en una cuenta de almacenamiento que ha habilitado NfsV3.

Ejemplo 5: Creación de un contenedor de almacenamiento y habilitación de Almacenamiento inmutable con control de versiones

$c = New-AzRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "mystorageaccount" -Name testcontainer -EnableImmutableStorageWithVersioning

$c

ResourceGroupName: myResourceGroup, StorageAccountName: mystorageaccount

Name          PublicAccess LastModified         HasLegalHold HasImmutabilityPolicy Deleted VersionId ImmutableStorageWithVersioning
----          ------------ ------------         ------------ --------------------- ------- --------- ------------------------------
testcontainer None         2021-07-19 08:26:19Z False        False                 False             True

Este comando crea un contenedor de almacenamiento y habilita el almacenamiento inmutable con control de versiones. El comando solo funciona cuando la cuenta de almacenamiento ya ha habilitado el control de versiones de blobs.

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

-DefaultEncryptionScope

El contenedor debe usar el ámbito de cifrado especificado para todas las escrituras.

Propiedades de parámetro

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

Conjuntos de parámetros

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan 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

-EnableImmutableStorageWithVersioning

Habilite almacenamiento inmutable con control de versiones en el nivel de contenedor.

Propiedades de parámetro

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

-Metadata

Metadatos del contenedor

Propiedades de parámetro

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

-Name

Nombre del contenedor

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:N, Nombre del Contenedor

Conjuntos de parámetros

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

-PreventEncryptionScopeOverride

Bloquear la invalidación del ámbito de cifrado del valor predeterminado del contenedor.

Propiedades de parámetro

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

Conjuntos de parámetros

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

-PublicAccess

Container PublicAccess

Propiedades de parámetro

Tipo:PSPublicAccess
Valor predeterminado:None
Valores aceptados:Container, Blob, 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:True
Valor de los argumentos restantes:False
AccountNameEncryptionScope
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

-RootSquash

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:NoRootSquash, RootSquash, AllSquash
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:True
Valor de los argumentos restantes:False
AccountObjectEncryptionScope
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
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

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:True
Valor de los argumentos restantes:False
AccountNameEncryptionScope
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
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

String

PSStorageAccount

Salidas

PSContainer