New-AzStorageContext
Vytvoří kontext služby Azure Storage.
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
Rutina New-AzStorageContext vytvoří kontext služby Azure Storage. Výchozí ověřování kontextu úložiště je OAuth (Microsoft Entra ID), pokud se jedná pouze o název vstupního účtu úložiště. Podrobnosti o ověřování služby Storage v https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-servicessouboru .
Příklady
Příklad 1: Vytvoření kontextu zadáním názvu a klíče účtu úložiště
New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"Tento příkaz vytvoří kontext pro účet s názvem ContosoGeneral, který používá zadaný klíč.
Příklad 2: Vytvoření kontextu zadáním připojovací řetězec
New-AzStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"Tento příkaz vytvoří kontext založený na zadaném připojovací řetězec pro účet ContosoGeneral.
Příklad 3: Vytvoření kontextu pro anonymní účet úložiště
New-AzStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"Tento příkaz vytvoří kontext pro anonymní použití pro účet s názvem ContosoGeneral. Příkaz určuje protokol HTTP jako protokol připojení.
Příklad 4: Vytvoření kontextu pomocí účtu místního vývojového úložiště
New-AzStorageContext -LocalTento příkaz vytvoří kontext pomocí účtu místního vývojového úložiště. Příkaz určuje místní parametr.
Příklad 5: Získání kontejneru pro účet místního úložiště pro vývojáře
New-AzStorageContext -Local | Get-AzStorageContainerTento příkaz vytvoří kontext pomocí účtu místního vývojového úložiště a pak předá nový kontext rutině Get-AzStorageContainer pomocí operátoru kanálu. Příkaz získá kontejner Azure Storage pro místní účet úložiště pro vývojáře.
Příklad 6: Získání více kontejnerů
$Context01 = New-AzStorageContext -Local
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainerPrvní příkaz vytvoří kontext pomocí účtu místního vývojového úložiště a pak tento kontext uloží do proměnné $Context 01. Druhý příkaz vytvoří kontext pro účet ContosoGeneral, který používá zadaný klíč, a pak tento kontext uloží do proměnné $Context 02. Poslední příkaz získá kontejnery pro kontexty uložené v $Context 01 a $Context 02 pomocí rutiny Get-AzStorageContainer.
Příklad 7: Vytvoření kontextu s koncovým bodem
New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"Tento příkaz vytvoří kontext služby Azure Storage, který má zadaný koncový bod úložiště. Příkaz vytvoří kontext pro účet s názvem ContosoGeneral, který používá zadaný klíč.
Příklad 8: Vytvoření kontextu se zadaným prostředím
New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"Tento příkaz vytvoří kontext úložiště Azure, který má zadané prostředí Azure. Příkaz vytvoří kontext pro účet s názvem ContosoGeneral, který používá zadaný klíč.
Příklad 9: Vytvoření kontextu pomocí tokenu SAS
$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"První příkaz vygeneruje token SAS pomocí rutiny New-AzStorageContainerSASToken pro kontejner s názvem ContosoMain a pak tento token uloží do proměnné $SasToken. Tento token slouží ke čtení, přidávání, aktualizaci a odstraňování oprávnění. Druhý příkaz vytvoří kontext pro účet ContosoGeneral, který používá token SAS uložený v $SasToken a pak tento kontext uloží do proměnné $Context. Poslední příkaz zobrazí seznam všech objektů blob přidružených ke kontejneru ContosoMain pomocí kontextu uloženého v $Context.
Příklad 10: Vytvoření kontextu pomocí ověřování OAuth
Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccountTento příkaz vytvoří kontext pomocí ověřování OAuth (Microsoft Entra ID).
Příklad 11: Vytvoření kontextu zadáním názvu účtu úložiště, klíče účtu úložiště a vlastního koncového bodu objektu blob
New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"Tento příkaz vytvoří kontext pro účet myaccountname s klíčem pro účet a zadaným koncovým bodem objektu blob.
Příklad 12: Vytvoření kontextu pro anonymní účet úložiště se zadaným koncovým bodem objektu blob
New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"Tento příkaz vytvoří kontext pro anonymní použití pro účet myaccountname se zadaným enpointem objektu blob.
Příklad 13: Vytvoření kontextu pomocí tokenu SAS se zadanými koncovými body
$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/"První příkaz vygeneruje token SAS pomocí rutiny New-AzStorageContainerSASToken pro kontejner s názvem MyContainer a pak tento token uloží do proměnné $SasToken. Druhý příkaz vytvoří kontext, který používá token SAS a zadaný koncový bod objektu blob, koncový bod tabulky, koncový bod souboru a koncový bod fronty.
Příklad 14: Vytvoření kontextu pomocí ověřování OAuth se zadaným koncovým bodem objektu blob
New-AzStorageContext -UseConnectedAccount -BlobEndpoint "https://myaccountname.blob.core.windows.net/"Tento příkaz vytvoří kontext pomocí ověřování OAuth se zadaným koncovým bodem objektu blob.
Příklad 15: Vytvoření kontextu pomocí ověřování OAuth ve službě File
New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntentTento příkaz vytvoří kontext pro použití ověřování OAuth (Microsoft Entra ID) ve službě File Service. Parametr -EnableFileBackupRequestIntent je nutný k použití ověřování OAuth (Microsoft Entra ID) pro souborovou službu. Tím se obejdou kontroly oprávnění na úrovni souborů nebo adresářů a povolí přístup na základě povolených datových akcí, a to i v případě, že jsou pro tyto soubory nebo adresáře zavedeny seznamy ACL.
Parametry
-Anonymous
Označuje, že tato rutina vytvoří kontext služby Azure Storage pro anonymní přihlášení.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlobEndpoint
Koncový bod služby Azure Storage Blob Service
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionString
Určuje připojovací řetězec pro kontext služby Azure Storage.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableFileBackupRequestIntent
Povinný parametr pro použití s ověřováním OAuth (Microsoft Entra ID) pro soubory. Tím se obejdou kontroly oprávnění na úrovni souborů nebo adresářů a povolí přístup na základě povolených datových akcí, a to i v případě, že jsou pro tyto soubory nebo adresáře zavedeny seznamy ACL.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Endpoint
Určuje koncový bod pro kontext služby Azure Storage.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Environment
Určuje prostředí Azure.
Přijatelné hodnoty pro tento parametr jsou: AzureCloud a AzureChinaCloud.
Další informace potřebujete zadáním 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
Koncový bod souborové služby Azure Storage
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Local
Označuje, že tato rutina vytvoří kontext pomocí účtu místního vývojového úložiště.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
Přenosový protokol (https/http).
| Type: | String |
| Accepted values: | Http, Https |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QueueEndpoint
Koncový bod služby fronty služby Azure Storage
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SasToken
Určuje token sdíleného přístupového podpisu (SAS) pro kontext.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountKey
Určuje klíč účtu služby Azure Storage. Tato rutina vytvoří kontext pro klíč, který tento parametr určuje.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountName
Určuje název účtu služby Azure Storage. Tato rutina vytvoří kontext pro účet, který tento parametr určuje.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TableEndpoint
Koncový bod služby Azure Storage Table Service
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseConnectedAccount
Označuje, že tato rutina vytvoří kontext služby Azure Storage s ověřováním OAuth (Microsoft Entra ID). Rutina ve výchozím nastavení použije ověřování OAuth, pokud není zadané jiné ověřování.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Vstupy
Výstupy
Související odkazy
Azure PowerShell
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro