New-AzStorageContext

Módulo:
Az.Storage Module

Crea un contexto de Azure Storage.

Sintaxis

OAuthAccount (valor predeterminado) 

New-AzStorageContext
    [-StorageAccountName] <String>
    [-UseConnectedAccount]
    [-Protocol <String>]
    [-Endpoint <String>]
    [-EnableFileBackupRequestIntent]
    [<CommonParameters>]

AccountNameAndKey 

New-AzStorageContext
    [-StorageAccountName] <String>
    [-StorageAccountKey] <String>
    [-Protocol <String>]
    [-Endpoint <String>]
    [<CommonParameters>]

AccountNameAndKeyEnvironment 

New-AzStorageContext
    [-StorageAccountName] <String>
    [-StorageAccountKey] <String>
    -Environment <String>
    [-Protocol <String>]
    [<CommonParameters>]

AnonymousAccount 

New-AzStorageContext
    [-StorageAccountName] <String>
    [-Anonymous]
    [-Protocol <String>]
    [-Endpoint <String>]
    [<CommonParameters>]

AnonymousAccountEnvironment 

New-AzStorageContext
    [-StorageAccountName] <String>
    -Environment <String>
    [-Anonymous]
    [-Protocol <String>]
    [<CommonParameters>]

SasToken 

New-AzStorageContext
    [-StorageAccountName] <String>
    -SasToken <String>
    [-Protocol <String>]
    [-Endpoint <String>]
    [<CommonParameters>]

SasTokenWithAzureEnvironment 

New-AzStorageContext
    [-StorageAccountName] <String>
    -SasToken <String>
    -Environment <String>
    [<CommonParameters>]

OAuthAccountEnvironment 

New-AzStorageContext
    [-StorageAccountName] <String>
    -Environment <String>
    [-UseConnectedAccount]
    [-Protocol <String>]
    [-EnableFileBackupRequestIntent]
    [<CommonParameters>]

AccountNameAndKeyServiceEndpoint 

New-AzStorageContext
    [-StorageAccountName] <String>
    [-StorageAccountKey] <String>
    -BlobEndpoint <String>
    [-FileEndpoint <String>]
    [-QueueEndpoint <String>]
    [-TableEndpoint <String>]
    [<CommonParameters>]

OAuthAccountServiceEndpoint 

New-AzStorageContext
    [[-StorageAccountName] <String>]
    [-UseConnectedAccount]
    [-BlobEndpoint <String>]
    [-FileEndpoint <String>]
    [-QueueEndpoint <String>]
    [-TableEndpoint <String>]
    [-EnableFileBackupRequestIntent]
    [<CommonParameters>]

SasTokenServiceEndpoint 

New-AzStorageContext
    -SasToken <String>
    [-BlobEndpoint <String>]
    [-FileEndpoint <String>]
    [-QueueEndpoint <String>]
    [-TableEndpoint <String>]
    [<CommonParameters>]

ConnectionString 

New-AzStorageContext
    -ConnectionString <String>
    [<CommonParameters>]

LocalDevelopment 

New-AzStorageContext
    [-Local]
    [<CommonParameters>]

AnonymousAccountServiceEndpoint 

New-AzStorageContext
    [-Anonymous]
    [-BlobEndpoint <String>]
    [-FileEndpoint <String>]
    [-QueueEndpoint <String>]
    [-TableEndpoint <String>]
    [<CommonParameters>]

Description

El cmdlet New-AzStorageContext crea un contexto de Azure Storage. La autenticación predeterminada de un contexto de almacenamiento es OAuth (Microsoft Entra ID), si solo se introduce el nombre de la cuenta de almacenamiento. Consulte los detalles de la autenticación del servicio de almacenamiento en https://dotnet.territoriali.olinfo.it/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 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 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 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 el uso anónimo de la cuenta denominada myaccountname, con el punto de conexión de blob especificado.

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 (Microsoft Entra ID) en el servicio File. Se requiere el parámetro "-EnableFileBackupRequestIntent" para usar la autenticación de OAuth (Microsoft Entra ID) para el servicio file. 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.

Propiedades de parámetro

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

Conjuntos de parámetros

AnonymousAccount
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
AnonymousAccountEnvironment
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
AnonymousAccountServiceEndpoint
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

-BlobEndpoint

Azure punto de conexión de Storage Blob Service

Propiedades de parámetro

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

Conjuntos de parámetros

AccountNameAndKeyServiceEndpoint
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

-ConnectionString

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

Propiedades de parámetro

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

Conjuntos de parámetros

ConnectionString
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

-EnableFileBackupRequestIntent

Parámetro necesario para usar con la 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.

Propiedades de parámetro

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

Conjuntos de parámetros

OAuthAccount
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
OAuthAccountEnvironment
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
OAuthAccountServiceEndpoint
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

-Endpoint

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

Propiedades de parámetro

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

Conjuntos de parámetros

OAuthAccount
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
AccountNameAndKey
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
AnonymousAccount
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
SasToken
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

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

Propiedades de parámetro

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

Conjuntos de parámetros

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

-FileEndpoint

Azure punto de conexión del servicio de archivos de almacenamiento

Propiedades de parámetro

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

Conjuntos de parámetros

AccountNameAndKeyServiceEndpoint
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
OAuthAccountServiceEndpoint
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
SasTokenServiceEndpoint
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
AnonymousAccountServiceEndpoint
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

-Local

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

Propiedades de parámetro

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

Conjuntos de parámetros

LocalDevelopment
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

-Protocol

Protocolo de transferencia (https/http).

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Http, Https
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

OAuthAccount
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
AccountNameAndKey
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
AccountNameAndKeyEnvironment
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
AnonymousAccount
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
AnonymousAccountEnvironment
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
SasToken
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
OAuthAccountEnvironment
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

-QueueEndpoint

Azure punto de conexión de servicio de cola de almacenamiento

Propiedades de parámetro

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

Conjuntos de parámetros

AccountNameAndKeyServiceEndpoint
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
OAuthAccountServiceEndpoint
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
SasTokenServiceEndpoint
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
AnonymousAccountServiceEndpoint
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

-SasToken

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

Propiedades de parámetro

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

Conjuntos de parámetros

SasToken
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
SasTokenWithAzureEnvironment
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
SasTokenServiceEndpoint
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

-StorageAccountKey

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

Propiedades de parámetro

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

Conjuntos de parámetros

AccountNameAndKey
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountNameAndKeyEnvironment
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountNameAndKeyServiceEndpoint
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-StorageAccountName

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

Propiedades de parámetro

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

Conjuntos de parámetros

OAuthAccount
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountNameAndKey
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountNameAndKeyEnvironment
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AnonymousAccount
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AnonymousAccountEnvironment
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
SasToken
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
SasTokenWithAzureEnvironment
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
OAuthAccountEnvironment
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountNameAndKeyServiceEndpoint
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TableEndpoint

punto de conexión de servicio de tabla de almacenamiento de Azure

Propiedades de parámetro

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

Conjuntos de parámetros

AccountNameAndKeyServiceEndpoint
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
OAuthAccountServiceEndpoint
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
SasTokenServiceEndpoint
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
AnonymousAccountServiceEndpoint
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

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

Propiedades de parámetro

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

Conjuntos de parámetros

OAuthAccount
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
OAuthAccountEnvironment
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
OAuthAccountServiceEndpoint
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

Salidas

AzureStorageContext