Share via

New-AzureStorageContext

  • Referencia
Modul:
Azure.Storage

Létrehoz egy Azure Storage-környezetet.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

Syntax

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

Description

A New-AzureStorageContext parancsmag létrehoz egy Azure Storage-környezetet.

Példák

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

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

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

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

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

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

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

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

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-AzureStorageContainer használatával.

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

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

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

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"

Az első parancs létrehoz egy SAS-jogkivonatot a ContosoMain nevű tároló New-AzureStorageContainerSASToken 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

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

Ez a parancs létrehoz egy környezetet az OAuth-hitelesítés használatával.

Paraméterek

-Anonymous

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionString

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Endpoint

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-AzureEnvironment:

Type:String
Aliases:Name, EnvironmentName
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Local

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

Átviteli protokoll (https/http).

Type:String
Accepted values:Http, Https
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SasToken

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StorageAccountKey

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UseConnectedAccount

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

String

Kimenetek

AzureStorageContext