New-AzureStorageContext

Skapar en Azure Storage-kontext.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Cmdleten New-AzureStorageContext skapar en Azure Storage-kontext.

Exempel

Exempel 1: Skapa en kontext genom att ange ett lagringskontonamn och en nyckel

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"

Det här kommandot skapar en kontext för kontot med namnet ContosoGeneral som använder den angivna nyckeln.

Exempel 2: Skapa en kontext genom att ange en anslutningssträng

C:\PS>New-AzureStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"

Det här kommandot skapar en kontext baserat på den angivna anslutningssträng för kontot ContosoGeneral.

Exempel 3: Skapa en kontext för ett anonymt lagringskonto

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"

Det här kommandot skapar en kontext för anonym användning för kontot med namnet ContosoGeneral. Kommandot anger HTTP som ett anslutningsprotokoll.

Exempel 4: Skapa en kontext med hjälp av lagringskontot för lokal utveckling

C:\PS>New-AzureStorageContext -Local

Det här kommandot skapar en kontext med hjälp av lagringskontot för lokal utveckling. Kommandot anger den lokala parametern.

Exempel 5: Hämta containern för det lokala utvecklarlagringskontot

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

Det här kommandot skapar en kontext med hjälp av lagringskontot för lokal utveckling och skickar sedan den nya kontexten till cmdleten Get-AzureStorageContainer med hjälp av pipelineoperatorn. Kommandot hämtar Azure Storage-containern för det lokala utvecklarlagringskontot.

Exempel 6: Hämta flera containrar

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

Det första kommandot skapar en kontext med hjälp av lagringskontot för lokal utveckling och lagrar sedan kontexten i variabeln $Context 01. Det andra kommandot skapar en kontext för kontot contosoGeneral som använder den angivna nyckeln och lagrar sedan kontexten i variabeln $Context 02. Det sista kommandot hämtar containrarna för de kontexter som lagras i $Context 01 och $Context 02 med hjälp av Get-AzureStorageContainer.

Exempel 7: Skapa en kontext med en slutpunkt

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"

Det här kommandot skapar en Azure Storage-kontext som har den angivna lagringsslutpunkten. Kommandot skapar kontexten för det konto med namnet ContosoGeneral som använder den angivna nyckeln.

Exempel 8: Skapa en kontext med en angiven miljö

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"

Det här kommandot skapar en Azure Storage-kontext som har den angivna Azure-miljön. Kommandot skapar kontexten för det konto med namnet ContosoGeneral som använder den angivna nyckeln.

Exempel 9: Skapa en kontext med hjälp av en SAS-token

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"

Det första kommandot genererar en SAS-token med hjälp av cmdleten New-AzureStorageContainerSASToken för containern ContosoMain och lagrar sedan den token i variabeln $SasToken. Den token används för läs-, tilläggs-, uppdaterings- och borttagningsbehörigheter. Det andra kommandot skapar en kontext för kontot ContosoGeneral som använder SAS-token som lagras i $SasToken och sedan lagrar kontexten i variabeln $Context. Det sista kommandot visar alla blobar som är associerade med containern med namnet ContosoMain med hjälp av kontexten som lagras i $Context.

Exempel 10: Skapa en kontext med hjälp av OAuth-autentiseringen

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

Det här kommandot skapar en kontext med hjälp av OAuth-autentiseringen.

Parametrar

-Anonymous

Anger att den här cmdleten skapar en Azure Storage-kontext för anonym inloggning.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConnectionString

Anger en anslutningssträng för Azure Storage-kontexten.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Endpoint

Anger slutpunkten för Azure Storage-kontexten.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Environment

Anger Azure-miljön. De godtagbara värdena för den här parametern är: AzureCloud och AzureChinaCloud. Om du vill ha mer information skriver du Get-Help Get-AzureEnvironment.

Typ:String
Alias:Name, EnvironmentName
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Local

Anger att den här cmdleten skapar en kontext med hjälp av lagringskontot för lokal utveckling.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Protocol

Transfer Protocol (https/http).

Typ:String
Godkända värden:Http, Https
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SasToken

Anger en SAS-token (Signatur för delad åtkomst) för kontexten.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-StorageAccountKey

Anger en Azure Storage-kontonyckel. Den här cmdleten skapar en kontext för nyckeln som den här parametern anger.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-StorageAccountName

Anger ett Azure Storage-kontonamn. Den här cmdleten skapar en kontext för det konto som den här parametern anger.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UseConnectedAccount

Anger att den här cmdleten skapar en Azure Storage-kontext med OAuth-autentisering. Cmdleten använder OAuth-autentisering som standard när annan autentisering inte har angetts.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Utdata

AzureStorageContext