New-AzStorageContext
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-Az Archiviazione Context crea un contesto Archiviazione di Azure. L'autenticazione predefinita di un contesto di Archiviazione è OAuth (MICROSOFT Entra ID), se solo l'input Archiviazione nome dell'account. Vedere i dettagli dell'autenticazione del servizio 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 -LocalQuesto 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-AzStorageContainerQuesto comando crea un contesto usando l'account di archiviazione di sviluppo locale e quindi passa il nuovo contesto al cmdlet Get-Az 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
$Context01 = New-AzStorageContext -Local
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainerIl 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-Az Archiviazione Container.
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-Az 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
Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccountQuesto 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-Az Archiviazione ContainerSASToken per il contenitore denominato MyContainer e quindi archivia il 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 -EnableFileBackupRequestIntentQuesto 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlobEndpoint
Endpoint del servizio BLOB di Archiviazione di Azure
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionString
Specifica un stringa di connessione per il contesto di Archiviazione di Azure.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Endpoint
Specifica l'endpoint per il contesto di Archiviazione di Azure.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Aliases: | Name, EnvironmentName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-FileEndpoint
Endpoint del servizio file di archiviazione di Azure
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Local
Indica che questo cmdlet crea un contesto usando l'account di archiviazione di sviluppo locale.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
Protocollo di trasferimento (https/http).
| Type: | String |
| Accepted values: | Http, Https |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QueueEndpoint
Endpoint del servizio di accodamento di Archiviazione di Azure
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SasToken
Specifica un token di firma di accesso condiviso per il contesto.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountKey
Specifica una chiave dell'account Archiviazione di Azure. Questo cmdlet crea un contesto per la chiave specificata da questo parametro.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountName
Specifica un nome di account Archiviazione di Azure. Questo cmdlet crea un contesto per l'account specificato da questo parametro.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TableEndpoint
Endpoint del servizio tabelle di Archiviazione di Azure
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
Output
Collegamenti correlati
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per