New-AzStorageContext
Crea un contexto de Azure Storage.
Syntax
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 -LocalEste 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-AzStorageContainerEste 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-AzStorageContainerEl 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" -UseConnectedAccountEste 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 -EnableFileBackupRequestIntentEste 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlobEndpoint
Punto de conexión de Azure Storage Blob Service
| Type: | String |
| 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 |
-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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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-AzEnvironment.
| Type: | String |
| Aliases: | Name, EnvironmentName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-FileEndpoint
Punto de conexión del servicio de archivos de Azure Storage
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-QueueEndpoint
Punto de conexión de servicio de cola de Azure Storage
| Type: | String |
| 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 |
-TableEndpoint
Punto de conexión de servicio de tabla de Azure Storage
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Salidas
Vínculos relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de