New-AzStorageContext

Reference

Modul:: Az.Storage

Vytvoří kontext služby Azure Storage.

Syntaxe

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 najdete v https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.

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ího řetězce

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ím řetězci 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 -Local

Tento příkaz vytvoří kontext pomocí účtu místního vývojového úložiště. Příkaz určuje parametr Local.

Příklad 5: Získání kontejneru pro účet místního úložiště pro vývojáře

New-AzStorageContext -Local | Get-AzStorageContainer

Tento příkaz vytvoří kontext pomocí účtu místního vývojového úložiště a potom 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-AzStorageContainer

První 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í 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 kontejneru 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" -UseConnectedAccount

Tento 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 -EnableFileBackupRequestIntent

Tento 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í.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-BlobEndpoint

Koncový bod služby Azure Storage Blob Service

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ConnectionString

Určuje připojovací řetězec pro kontext služby Azure Storage.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Endpoint

Určuje koncový bod pro kontext služby Azure Storage.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	String
Aliasy:	Name, EnvironmentName
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-FileEndpoint

Koncový bod souborové služby Azure Storage

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Local

Označuje, že tato rutina vytvoří kontext pomocí účtu místního vývojového úložiště.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Protocol

Přenosový protokol (https/http).

Typ:	String
Přípustné hodnoty:	Http, Https
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-QueueEndpoint

Koncový bod služby fronty služby Azure Storage

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SasToken

Určuje token sdíleného přístupového podpisu (SAS) pro kontext.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StorageAccountKey

Určuje klíč účtu služby Azure Storage. Tato rutina vytvoří kontext pro klíč, který tento parametr určuje.

Typ:	String
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StorageAccountName

Určuje název účtu služby Azure Storage. Tato rutina vytvoří kontext pro účet, který tento parametr určuje.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-TableEndpoint

Koncový bod služby Azure Storage Table Service

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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í.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

Výstupy

AzureStorageContext

Sdílet prostřednictvím

New-AzStorageContext

Syntaxe

Description

Příklady

Příklad 1: Vytvoření kontextu zadáním názvu a klíče účtu úložiště

Příklad 2: Vytvoření kontextu zadáním připojovacího řetězce

Příklad 3: Vytvoření kontextu pro anonymní účet úložiště

Příklad 4: Vytvoření kontextu pomocí účtu místního vývojového úložiště

Příklad 5: Získání kontejneru pro účet místního úložiště pro vývojáře

Příklad 6: Získání více kontejnerů

Příklad 7: Vytvoření kontextu s koncovým bodem

Příklad 8: Vytvoření kontextu se zadaným prostředím

Příklad 9: Vytvoření kontextu pomocí tokenu SAS

Příklad 10: Vytvoření kontextu pomocí ověřování OAuth

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

Příklad 12: Vytvoření kontextu pro anonymní účet úložiště se zadaným koncovým bodem objektu blob

Příklad 13: Vytvoření kontextu pomocí tokenu SAS se zadanými koncovými body

Příklad 14: Vytvoření kontextu 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

Parametry

-Anonymous

-BlobEndpoint

-ConnectionString

-EnableFileBackupRequestIntent

-Endpoint

-Environment

-FileEndpoint

-Local

-Protocol

-QueueEndpoint

-SasToken

-StorageAccountKey

-StorageAccountName

-TableEndpoint

-UseConnectedAccount

Vstupy

Výstupy

Další materiály

Sdílet prostřednictvím

New-AzStorageContext

Syntaxe

Description

Příklady

Příklad 1: Vytvoření kontextu zadáním názvu a klíče účtu úložiště

Příklad 2: Vytvoření kontextu zadáním připojovacího řetězce

Příklad 3: Vytvoření kontextu pro anonymní účet úložiště

Příklad 4: Vytvoření kontextu pomocí účtu místního vývojového úložiště

Příklad 5: Získání kontejneru pro účet místního úložiště pro vývojáře

Příklad 6: Získání více kontejnerů

Příklad 7: Vytvoření kontextu s koncovým bodem

Příklad 8: Vytvoření kontextu se zadaným prostředím

Příklad 9: Vytvoření kontextu pomocí tokenu SAS

Příklad 10: Vytvoření kontextu pomocí ověřování OAuth

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

Příklad 12: Vytvoření kontextu pro anonymní účet úložiště se zadaným koncovým bodem objektu blob

Příklad 13: Vytvoření kontextu pomocí tokenu SAS se zadanými koncovými body

Příklad 14: Vytvoření kontextu 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

Parametry

-Anonymous

-BlobEndpoint

-ConnectionString

-EnableFileBackupRequestIntent

-Endpoint

-Environment

-FileEndpoint

-Local

-Protocol

-QueueEndpoint

-SasToken

-StorageAccountKey

-StorageAccountName

-TableEndpoint

-UseConnectedAccount

Vstupy

Výstupy

Související odkazy

Další materiály