Condividi tramite


New-AzureStorageContext

Crea un contesto di Archiviazione di Azure.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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

Descrizione

Il cmdlet New-Azure Archiviazione Context crea un contesto di Archiviazione di Azure.

Esempio

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

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

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

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

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

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

Questo comando crea un contesto usando l'account di archiviazione di sviluppo locale e quindi passa il nuovo contesto al cmdlet Get-Azure Archiviazione Container 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

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

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-Azure Archiviazione Container.

Esempio 7: Creare un contesto con un endpoint

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

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

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"

Il primo comando genera un token di firma di accesso condiviso usando il cmdlet New-Azure Archiviazione ContainerSASToken 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

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

Questo comando crea un contesto usando l'autenticazione OAuth.

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

-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

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

Tipo:String
Alias:Name, EnvironmentName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
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

-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

-UseConnectedAccount

Indica che questo cmdlet crea un contesto Archiviazione di Azure con l'autenticazione OAuth. 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