Compartir a través de

New-AzStorageContext

  • Referencia
Módulo:
Az.Storage

Crea un contexto de Azure Storage.

Sintaxis

New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   [-Endpoint <String>]
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   -Environment <String>
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   -Environment <String>
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   -BlobEndpoint <String>
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   -SasToken <String>
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   -ConnectionString <String>
   [<CommonParameters>]
New-AzStorageContext
   [-Local]
   [<CommonParameters>]
New-AzStorageContext
   [-Anonymous]
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   [-UseConnectedAccount]
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]

Description

El cmdlet New-AzStorageContext crea un contexto de Azure Storage. La autenticación predeterminada de un contexto de almacenamiento es OAuth (id. de Microsoft Entra), si solo se introduce el nombre de la cuenta de almacenamiento. Consulte los detalles de la autenticación del servicio de almacenamiento en https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.

Ejemplos

Ejemplo 1: Creación de un contexto mediante la especificación de un nombre y una clave de la cuenta de almacenamiento

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"

Este comando crea un contexto para la cuenta denominada ContosoGeneral que usa la clave especificada.

Ejemplo 2: Crear un contexto especificando un cadena de conexión

New-AzStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"

Este comando crea un contexto basado en el cadena de conexión especificado para la cuenta ContosoGeneral.

Ejemplo 3: Creación de un contexto para una cuenta de almacenamiento anónima

New-AzStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"

Este comando crea un contexto para uso anónimo para la cuenta denominada ContosoGeneral. El comando especifica HTTP como protocolo de conexión.

Ejemplo 4: Creación de un contexto mediante la cuenta de almacenamiento de desarrollo local

New-AzStorageContext -Local

Este comando crea un contexto mediante la cuenta de almacenamiento de desarrollo local. El comando especifica el parámetro Local .

Ejemplo 5: Obtención del contenedor de la cuenta de almacenamiento de desarrollador local

New-AzStorageContext -Local | Get-AzStorageContainer

Este comando crea un contexto mediante la cuenta de almacenamiento de desarrollo local y, a continuación, pasa el nuevo contexto al cmdlet Get-AzStorageContainer mediante el operador de canalización. El comando obtiene el contenedor de Azure Storage para la cuenta de almacenamiento de desarrollador local.

Ejemplo 6: Obtención de varios contenedores

$Context01 = New-AzStorageContext -Local 
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainer

El primer comando crea un contexto mediante la cuenta de almacenamiento de desarrollo local y, a continuación, almacena ese contexto en la variable $Context 01. El segundo comando crea un contexto para la cuenta denominada ContosoGeneral que usa la clave especificada y, a continuación, almacena ese contexto en la variable $Context 02. El comando final obtiene los contenedores de los contextos almacenados en $Context 01 y $Context 02 mediante Get-AzStorageContainer.

Ejemplo 7: Creación de un contexto con un punto de conexión

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"

Este comando crea un contexto de Azure Storage que tiene el punto de conexión de almacenamiento especificado. El comando crea el contexto de la cuenta denominada ContosoGeneral que usa la clave especificada.

Ejemplo 8: Crear un contexto con un entorno especificado

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"

Este comando crea un contexto de almacenamiento de Azure que tiene el entorno de Azure especificado. El comando crea el contexto de la cuenta denominada ContosoGeneral que usa la clave especificada.

Ejemplo 9: Creación de un contexto mediante un token de SAS

$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"

El primer comando genera un token de SAS mediante el cmdlet New-AzStorageContainerSASToken para el contenedor denominado ContosoMain y, a continuación, almacena ese token en la variable $SasToken. Ese token es para permisos de lectura, adición, actualización y eliminación. El segundo comando crea un contexto para la cuenta denominada ContosoGeneral que usa el token de SAS almacenado en $SasToken y, a continuación, almacena ese contexto en la variable $Context. El comando final enumera todos los blobs asociados al contenedor denominado ContosoMain mediante el contexto almacenado en $Context.

Ejemplo 10: Creación de un contexto mediante la autenticación de OAuth

Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

Este comando crea un contexto mediante la autenticación de OAuth (Microsoft Entra ID).

Ejemplo 11: Creación de un contexto especificando un nombre de cuenta de almacenamiento, una clave de cuenta de almacenamiento y un punto de conexión de blob personalizado

New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Este comando crea un contexto para la cuenta denominada myaccountname con una clave para la cuenta y el punto de conexión de blob especificado.

Ejemplo 12: Creación de un contexto para una cuenta de almacenamiento anónima con el punto de conexión de blob especificado

New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Este comando crea un contexto para uso anónimo para la cuenta denominada myaccountname, con el blob especificado enpoint.

Ejemplo 13: Creación de un contexto mediante un token de SAS con puntos de conexión especificados

$SasToken = New-AzStorageContainerSASToken -Name "MyContainer" -Permission "rad"
New-AzStorageContext -SasToken $SasToken -BlobEndpoint "https://myaccountname.blob.core.windows.net/" -TableEndpoint "https://myaccountname.table.core.windows.net/" -FileEndpoint "https://myaccountname.file.core.windows.net/" -QueueEndpoint "https://myaccountname.queue.core.windows.net/"

El primer comando genera un token de SAS mediante el cmdlet New-AzStorageContainerSASToken para el contenedor denominado MyContainer y, a continuación, almacena ese token en la variable $SasToken. El segundo comando crea un contexto que usa el token de SAS y un punto de conexión de blob especificado, punto de conexión de tabla, punto de conexión de archivo y punto de conexión de cola.

Ejemplo 14: Creación de un contexto mediante la autenticación de OAuth con un punto de conexión de blob especificado

New-AzStorageContext -UseConnectedAccount -BlobEndpoint  "https://myaccountname.blob.core.windows.net/"

Este comando crea un contexto mediante la autenticación de OAuth con un punto de conexión de blob especificado.

Ejemplo 15: Creación de un contexto mediante la autenticación de OAuth en el servicio de archivos

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent

Este comando crea un contexto para usar la autenticación de OAuth (Id. de Microsoft Entra) en el servicio file. Se requiere el parámetro "-EnableFileBackupRequestIntent" para usar la autenticación de OAuth (Microsoft Entra ID) para el servicio de archivos. Esto omitirá las comprobaciones de permisos de nivel de archivo o directorio y permitirá el acceso, en función de las acciones de datos permitidas, incluso si hay ACL en vigor para esos archivos o directorios.

Parámetros

-Anonymous

Indica que este cmdlet crea un contexto de Azure Storage para el inicio de sesión anónimo.

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

-BlobEndpoint

Punto de conexión de Azure Storage Blob Service

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

-ConnectionString

Especifica un cadena de conexión para el contexto de Azure Storage.

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

-EnableFileBackupRequestIntent

Parámetro necesario para usar con autenticación de OAuth (Microsoft Entra ID) para archivos. Esto omitirá las comprobaciones de permisos de nivel de archivo o directorio y permitirá el acceso, en función de las acciones de datos permitidas, incluso si hay ACL en vigor para esos archivos o directorios.

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

-Endpoint

Especifica el punto de conexión para el contexto de Azure Storage.

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

-Environment

Especifica el entorno de Azure. Los valores aceptables para este parámetro son: AzureCloud y AzureChinaCloud. Para obtener más información, escriba Get-Help Get-AzEnvironment.

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

-FileEndpoint

Punto de conexión del servicio de archivos de Azure Storage

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

-Local

Indica que este cmdlet crea un contexto mediante la cuenta de almacenamiento de desarrollo local.

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

-Protocol

Protocolo de transferencia (https/http).

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

-QueueEndpoint

Punto de conexión de servicio de cola de Azure Storage

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

-SasToken

Especifica un token de firma de acceso compartido (SAS) para el contexto.

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

-StorageAccountKey

Especifica una clave de cuenta de Azure Storage. Este cmdlet crea un contexto para la clave que especifica este parámetro.

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

-StorageAccountName

Especifica un nombre de cuenta de Azure Storage. Este cmdlet crea un contexto para la cuenta que especifica este parámetro.

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

-TableEndpoint

Punto de conexión de servicio de tabla de Azure Storage

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

-UseConnectedAccount

Indica que este cmdlet crea un contexto de Azure Storage con autenticación de OAuth (Microsoft Entra ID). El cmdlet usará la autenticación de OAuth de forma predeterminada, cuando no se especifique otra autenticación.

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

Entradas

String

Salidas

AzureStorageContext