Compartir a través de

New-AzureStorageContext

  • Referencia
Módulo:
Azure.Storage

Crea un contexto de Azure Storage.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente 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 se mantiene ni se admite, colocando cualquier uso continuado 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.

Syntax

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionString

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Endpoint

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:Name, EnvironmentName
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Local

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

Protocolo de transferencia (https/http).

Type:String
Accepted values:Http, Https
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SasToken

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StorageAccountKey

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StorageAccountName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Salidas

AzureStorageContext