Compartir a través de

New-AzureStorageContext

  • Referencia
Módulo:
Azure.Storage

Crea un contexto de Azure Storage.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

New-AzureStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   -Environment <String>
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzureStorageContext
   -ConnectionString <String>
   [<CommonParameters>]
New-AzureStorageContext
   [-Local]
   [<CommonParameters>]

Description

El cmdlet New-AzureStorageContext crea un contexto de Azure Storage.

Ejemplos

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

C:\PS>New-AzureStorageContext -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

C:\PS>New-AzureStorageContext -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

C:\PS>New-AzureStorageContext -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

C:\PS>New-AzureStorageContext -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

C:\PS>New-AzureStorageContext -Local | Get-AzureStorageContainer

Este comando crea un contexto mediante la cuenta de almacenamiento de desarrollo local y, a continuación, pasa el nuevo contexto al cmdlet Get-AzureStorageContainer 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

C:\PS>$Context01 = New-AzureStorageContext -Local 
PS C:\> $Context02 = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
PS C:\> ($Context01, $Context02) | Get-AzureStorageContainer

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-AzureStorageContainer.

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

C:\PS>New-AzureStorageContext -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

C:\PS>New-AzureStorageContext -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

C:\PS>$SasToken = New-AzureStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
PS C:\> $Context = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
PS C:\> $Context | Get-AzureStorageBlob -Container "ContosoMain"

El primer comando genera un token de SAS mediante el cmdlet New-AzureStorageContainerSASToken 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

C:\PS>Connect-AzureRmAccount
C:\PS> $Context = New-AzureStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

Este comando crea un contexto mediante la autenticación de OAuth.

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

-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

-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-AzureEnvironment.

Tipo:String
Alias:Name, EnvironmentName
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
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

-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

-UseConnectedAccount

Indica que este cmdlet crea un contexto de Azure Storage con autenticación de OAuth. 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