Condividi tramite

New-AzStorageContext

  • Riferimento
Modulo:
Az.Storage

Crea un contesto di Archiviazione di Azure.

Sintassi

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

Descrizione

Il cmdlet New-AzStorageContext crea un contesto Archiviazione di Azure. L'autenticazione predefinita di un contesto di archiviazione è OAuth (ID Microsoft Entra), se solo il nome dell'account di archiviazione di input. Vedere i dettagli dell'autenticazione del servizio di archiviazione in https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.

Esempio

Esempio 1: Creare un contesto specificando un nome e una chiave dell'account di archiviazione

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

Questo comando crea un contesto per l'account denominato ContosoGeneral che usa la chiave specificata.

Esempio 2: Creare un contesto specificando un stringa di connessione

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

Questo comando crea un contesto basato sul stringa di connessione specificato per l'account ContosoGeneral.

Esempio 3: Creare un contesto per un account di archiviazione anonimo

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

Questo comando crea un contesto per l'uso anonimo per l'account denominato ContosoGeneral. Il comando specifica HTTP come protocollo di connessione.

Esempio 4: Creare un contesto usando l'account di archiviazione di sviluppo locale

New-AzStorageContext -Local

Questo comando crea un contesto usando l'account di archiviazione di sviluppo locale. Il comando specifica il parametro Local .

Esempio 5: Ottenere il contenitore per l'account di archiviazione per sviluppatori locale

New-AzStorageContext -Local | Get-AzStorageContainer

Questo comando crea un contesto usando l'account di archiviazione di sviluppo locale e quindi passa il nuovo contesto al cmdlet Get-AzStorageContainer usando l'operatore pipeline. Il comando ottiene il contenitore Archiviazione di Azure per l'account di archiviazione per sviluppatori locale.

Esempio 6: Ottenere più contenitori

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

Il primo comando crea un contesto usando l'account di archiviazione di sviluppo locale e quindi archivia tale contesto nella variabile $Context 01. Il secondo comando crea un contesto per l'account denominato ContosoGeneral che usa la chiave specificata e quindi archivia tale contesto nella variabile $Context 02. Il comando finale ottiene i contenitori per i contesti archiviati in $Context 01 e $Context 02 usando Get-AzStorageContainer.

Esempio 7: Creare un contesto con un endpoint

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

Questo comando crea un contesto Archiviazione di Azure con l'endpoint di archiviazione specificato. Il comando crea il contesto per l'account denominato ContosoGeneral che usa la chiave specificata.

Esempio 8: Creare un contesto con un ambiente specificato

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

Questo comando crea un contesto di archiviazione di Azure con l'ambiente Azure specificato. Il comando crea il contesto per l'account denominato ContosoGeneral che usa la chiave specificata.

Esempio 9: Creare un contesto usando un token di firma di accesso condiviso

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

Il primo comando genera un token di firma di accesso condiviso usando il cmdlet New-AzStorageContainerSASToken per il contenitore denominato ContosoMain e quindi archivia tale token nella variabile $SasToken. Tale token è destinato alle autorizzazioni di lettura, aggiunta, aggiornamento ed eliminazione. Il secondo comando crea un contesto per l'account denominato ContosoGeneral che usa il token di firma di accesso condiviso archiviato in $SasToken e quindi archivia tale contesto nella variabile $Context. Il comando finale elenca tutti i BLOB associati al contenitore denominato ContosoMain usando il contesto archiviato in $Context.

Esempio 10: Creare un contesto usando l'autenticazione OAuth

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

Questo comando crea un contesto usando l'autenticazione OAuth (Microsoft Entra ID).

Esempio 11: Creare un contesto specificando un nome dell'account di archiviazione, una chiave dell'account di archiviazione e un endpoint BLOB personalizzato

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

Questo comando crea un contesto per l'account denominato myaccountname con una chiave per l'account e l'endpoint BLOB specificato.

Esempio 12: Creare un contesto per un account di archiviazione anonimo con l'endpoint BLOB specificato

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

Questo comando crea un contesto per l'uso anonimo per l'account denominato myaccountname, con l'enpoint blob specificato.

Esempio 13: Creare un contesto usando un token di firma di accesso condiviso con gli endpoint specificati

$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/"

Il primo comando genera un token di firma di accesso condiviso usando il cmdlet New-AzStorageContainerSASToken per il contenitore denominato MyContainer e quindi archivia tale token nella variabile $SasToken. Il secondo comando crea un contesto che usa il token di firma di accesso condiviso e un endpoint BLOB, un endpoint di tabella, un endpoint di file e un endpoint della coda specificati.

Esempio 14: Creare un contesto usando l'autenticazione OAuth con un endpoint BLOB specificato

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

Questo comando crea un contesto usando l'autenticazione OAuth con un endpoint BLOB specificato.

Esempio 15: Creare un contesto usando l'autenticazione OAuth nel servizio file

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

Questo comando crea un contesto per usare l'autenticazione OAuth (Microsoft Entra ID) nel servizio file. Il parametro '-EnableFileBackupRequestIntent' è necessario per usare l'autenticazione OAuth (Microsoft Entra ID) per il servizio file. In questo modo verranno ignorati i controlli delle autorizzazioni a livello di file/directory e verrà consentito l'accesso, in base alle azioni di dati consentite, anche se sono presenti elenchi di controllo di accesso per tali file/directory.

Parametri

-Anonymous

Indica che questo cmdlet crea un contesto Archiviazione di Azure per l'accesso anonimo.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BlobEndpoint

Endpoint del servizio BLOB di Archiviazione di Azure

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ConnectionString

Specifica un stringa di connessione per il contesto di Archiviazione di Azure.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableFileBackupRequestIntent

Parametro obbligatorio da usare con l'autenticazione OAuth (Microsoft Entra ID) per i file. In questo modo verranno ignorati i controlli delle autorizzazioni a livello di file/directory e verrà consentito l'accesso, in base alle azioni di dati consentite, anche se sono presenti elenchi di controllo di accesso per tali file/directory.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Endpoint

Specifica l'endpoint per il contesto di Archiviazione di Azure.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Environment

Specifica l'ambiente di Azure. I valori accettabili per questo parametro sono AzureCloud e AzureChinaCloud. Per ulteriori informazioni, digitare Get-Help Get-AzEnvironment.

Tipo:String
Alias:Name, EnvironmentName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-FileEndpoint

Endpoint del servizio file di archiviazione di Azure

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Local

Indica che questo cmdlet crea un contesto usando l'account di archiviazione di sviluppo locale.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Protocol

Protocollo di trasferimento (https/http).

Tipo:String
Valori accettati:Http, Https
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-QueueEndpoint

Endpoint del servizio di accodamento di Archiviazione di Azure

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SasToken

Specifica un token di firma di accesso condiviso per il contesto.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StorageAccountKey

Specifica una chiave dell'account Archiviazione di Azure. Questo cmdlet crea un contesto per la chiave specificata da questo parametro.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StorageAccountName

Specifica un nome di account Archiviazione di Azure. Questo cmdlet crea un contesto per l'account specificato da questo parametro.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TableEndpoint

Endpoint del servizio tabelle di Archiviazione di Azure

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UseConnectedAccount

Indica che questo cmdlet crea un contesto di Archiviazione di Azure con l'autenticazione OAuth (Microsoft Entra ID). Il cmdlet userà l'autenticazione OAuth per impostazione predefinita, quando non viene specificata un'altra autenticazione.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

Output

AzureStorageContext