New-AzStorageContext
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 -LocalEz 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-AzStorageContainerEz 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-AzStorageContainerAz 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" -UseConnectedAccountEz 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 -EnableFileBackupRequestIntentEz 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlobEndpoint
Azure Storage-blobszolgáltatás végpontja
| Type: | String |
| 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 |
-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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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-AzEnvironment:
| Type: | String |
| Aliases: | Name, EnvironmentName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-FileEndpoint
Azure Storage-fájlszolgáltatás végpontja
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-QueueEndpoint
Azure Storage-üzenetsor szolgáltatásvégpontja
| Type: | String |
| 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 |
-TableEndpoint
Azure Storage Table Service-végpont
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Bevitelek
Kimenetek
Kapcsolódó hivatkozások
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: