New-AzureStorageContext
Vytvoří kontext služby Azure Storage.
Upozorňující
Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntaxe
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
Rutina New-AzureStorageContext vytvoří kontext služby Azure Storage.
Příklady
Příklad 1: Vytvoření kontextu zadáním názvu a klíče účtu úložiště
C:\PS>New-AzureStorageContext -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
C:\PS>New-AzureStorageContext -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ě
C:\PS>New-AzureStorageContext -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ě
C:\PS>New-AzureStorageContext -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
C:\PS>New-AzureStorageContext -Local | Get-AzureStorageContainerTento příkaz vytvoří kontext pomocí účtu místního vývojového úložiště a potom předá nový kontext rutině Get-AzureStorageContainer 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ů
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-AzureStorageContainerPrvní 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-AzureStorageContainer.
Příklad 7: Vytvoření kontextu s koncovým bodem
C:\PS>New-AzureStorageContext -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
C:\PS>New-AzureStorageContext -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
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"První příkaz vygeneruje token SAS pomocí rutiny New-AzureStorageContainerSASToken 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
C:\PS>Connect-AzureRmAccount
C:\PS> $Context = New-AzureStorageContext -StorageAccountName "myaccountname" -UseConnectedAccountTento příkaz vytvoří kontext pomocí ověřování OAuth.
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 |
-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 |
-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-AzureEnvironment.
| 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 |
-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 |
-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 |
-UseConnectedAccount
Označuje, že tato rutina vytvoří kontext služby Azure Storage s ověřováním OAuth. 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 |