Megosztás a következőn keresztül:

New-AzStorageContext

  • Referencia
Modul:
Az.Storage

Létrehoz egy Azure Storage-környezetet.

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

A New-AzStorageContext parancsmag létrehoz egy Azure Storage-környezetet. A tárolási környezet alapértelmezett hitelesítése az OAuth (Microsoft Entra ID), ha csak a bemeneti Tárfiók neve. A Storage szolgáltatás hitelesítésének részletei a következőben találhatók https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services: .

Példák

1. példa: Környezet létrehozása egy tárfiók nevének és kulcsának megadásával

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

Ez a parancs létrehoz egy környezetet a contosoGeneral nevű fiókhoz, amely a megadott kulcsot használja.

2. példa: Környezet létrehozása egy kapcsolati sztring megadásával

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

Ez a parancs létrehoz egy környezetet a ContosoGeneral fiókhoz megadott kapcsolati sztring alapján.

3. példa: Környezet létrehozása névtelen tárfiókhoz

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

Ez a parancs létrehoz egy környezetet a ContosoGeneral nevű fiók névtelen használatához. A parancs a HTTP-t adja meg kapcsolati protokollként.

4. példa: Környezet létrehozása a helyi fejlesztési tárfiók használatával

New-AzStorageContext -Local

Ez a parancs létrehoz egy környezetet a helyi fejlesztési tárfiók használatával. A parancs a Helyi paramétert adja meg.

5. példa: A helyi fejlesztői tárfiók tárolójának lekérése

New-AzStorageContext -Local | Get-AzStorageContainer

Ez a parancs létrehoz egy környezetet a helyi fejlesztési tárfiók használatával, majd átadja az új környezetet a Get-AzStorageContainer parancsmagnak a folyamatkezelő használatával. A parancs lekéri a helyi fejlesztői tárfiókHoz tartozó Azure Storage-tárolót.

6. példa: Több tároló lekérése

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

Az első parancs létrehoz egy környezetet a helyi fejlesztési tárfiók használatával, majd ezt a környezetet a $Context 01 változóban tárolja. A második parancs létrehoz egy környezetet a megadott kulcsot használó ContosoGeneral fiókhoz, majd ezt a környezetet a $Context 02 változóban tárolja. Az utolsó parancs lekéri a $Context 01-ben és $Context 02-ben tárolt környezetek tárolóit a Get-AzStorageContainer használatával.

7. példa: Környezet létrehozása végponttal

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

Ez a parancs létrehoz egy Azure Storage-környezetet, amely a megadott tárolási végpontot tárolja. A parancs létrehozza a megadott kulcsot használó ContosoGeneral nevű fiók környezetét.

8. példa: Környezet létrehozása adott környezettel

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

Ez a parancs létrehoz egy Azure Storage-környezetet, amely rendelkezik a megadott Azure-környezettel. A parancs létrehozza a megadott kulcsot használó ContosoGeneral nevű fiók környezetét.

9. példa: Környezet létrehozása SAS-jogkivonat használatával

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

Az első parancs létrehoz egy SAS-jogkivonatot a ContosoMain nevű tároló New-AzStorageContainerSASToken parancsmagjával, majd a tokent a $SasToken változóban tárolja. Ez a jogkivonat olvasási, hozzáadási, frissítési és törlési engedélyeket biztosít. A második parancs létrehoz egy környezetet a ContosoGeneral nevű fiókhoz, amely a $SasToken tárolt SAS-jogkivonatot használja, majd ezt a környezetet a $Context változóban tárolja. Az utolsó parancs felsorolja a ContosoMain nevű tárolóhoz társított összes blobot a $Context tárolt környezet használatával.

10. példa: Környezet létrehozása az OAuth-hitelesítés használatával

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

Ez a parancs az OAuth (Microsoft Entra ID) hitelesítéssel hoz létre egy környezetet.

11. példa: Környezet létrehozása tárfióknév, tárfiókkulcs és egyéni blobvégpont megadásával

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

Ez a parancs létrehoz egy környezetet a fiókhoz tartozó kulccsal rendelkező myaccountname nevű fiókhoz és a megadott blobvégponthoz.

12. példa: Környezet létrehozása megadott blobvégponttal rendelkező névtelen tárfiókhoz

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

Ez a parancs létrehoz egy környezetet a myaccountname nevű fiók névtelen használatához a megadott blob-enpointtal.

13. példa: Környezet létrehozása SAS-jogkivonat használatával megadott végpontokkal

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

Az első parancs létrehoz egy SAS-jogkivonatot a New-AzStorageContainerSASToken parancsmaggal a MyContainer nevű tárolóhoz, majd a tokent a $SasToken változóban tárolja. A második parancs létrehoz egy környezetet, amely az SAS-jogkivonatot és egy megadott blobvégpontot, táblavégpontot, fájlvégpontot és üzenetsorvégpontot használ.

14. példa: Környezet létrehozása az OAuth-hitelesítéssel egy megadott blobvégponttal

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

Ez a parancs létrehoz egy környezetet az OAuth-hitelesítéssel egy megadott blobvégponttal.

15. példa: Környezet létrehozása az OAuth Authentication on File service használatával

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

Ez a parancs létrehoz egy környezetet, amely az OAuth (Microsoft Entra ID) hitelesítést használja a Fájlszolgáltatásban. Az "-EnableFileBackupRequestIntent" paraméter az OAuth (Microsoft Entra ID) hitelesítés fájlszolgáltatáshoz való használatához szükséges. Ez megkerüli a fájl-/könyvtárszintű engedélyellenőrzéseket, és engedélyezi a hozzáférést az engedélyezett adatműveletek alapján, még akkor is, ha ezekhez a fájlokhoz/könyvtárakhoz ACL-ek vannak érvényben.

Paraméterek

-Anonymous

Azt jelzi, hogy ez a parancsmag létrehoz egy Azure Storage-környezetet a névtelen bejelentkezéshez.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-BlobEndpoint

Azure Storage-blobszolgáltatás végpontja

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ConnectionString

Megadja az Azure Storage-környezethez tartozó kapcsolati sztring.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-EnableFileBackupRequestIntent

A fájlok OAuth (Microsoft Entra ID) hitelesítéséhez szükséges paraméter. Ez megkerüli a fájl-/könyvtárszintű engedélyellenőrzéseket, és engedélyezi a hozzáférést az engedélyezett adatműveletek alapján, még akkor is, ha ezekhez a fájlokhoz/könyvtárakhoz ACL-ek vannak érvényben.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Endpoint

Az Azure Storage-környezet végpontjának megadása.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Environment

Az Azure-környezetet adja meg. A paraméter elfogadható értékei a következők: AzureCloud és AzureChinaCloud. További információkért írja be a következőt Get-Help Get-AzEnvironment:

Típus:String
Aliasok:Name, EnvironmentName
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-FileEndpoint

Azure Storage-fájlszolgáltatás végpontja

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Local

Azt jelzi, hogy ez a parancsmag létrehoz egy környezetet a helyi fejlesztési tárfiók használatával.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Protocol

Átviteli protokoll (https/http).

Típus:String
Elfogadott értékek:Http, Https
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-QueueEndpoint

Azure Storage-üzenetsor szolgáltatásvégpontja

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SasToken

A környezethez egy közös hozzáférésű jogosultságkód (SAS) jogkivonatot ad meg.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-StorageAccountKey

Egy Azure Storage-fiókkulcsot ad meg. Ez a parancsmag létrehoz egy környezetet a paraméter által megadott kulcshoz.

Típus:String
Position:1
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-StorageAccountName

Az Azure Storage-fiók nevét adja meg. Ez a parancsmag létrehoz egy környezetet a paraméter által megadott fiókhoz.

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-TableEndpoint

Azure Storage Table Service-végpont

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-UseConnectedAccount

Azt jelzi, hogy ez a parancsmag létrehoz egy Azure Storage-környezetet OAuth (Microsoft Entra ID) hitelesítéssel. A parancsmag alapértelmezés szerint OAuth-hitelesítést használ, ha más hitelesítés nincs megadva.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

String

Kimenetek

AzureStorageContext