Dela via

New-AzStorageContext

  • Referens
Modul:
Az.Storage

Skapar en Azure Storage-kontext.

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

Cmdleten New-AzStorageContext skapar en Azure Storage-kontext. Standardautentisering för en lagringskontext är OAuth (Microsoft Entra-ID), om det bara anger lagringskontonamnet. Se information om autentisering av lagringstjänsten i https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.

Exempel

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

New-AzStorageContext -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

New-AzStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"

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

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

New-AzStorageContext -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

New-AzStorageContext -Local

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

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

New-AzStorageContext -Local | Get-AzStorageContainer

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-AzStorageContainer med hjälp av pipelineoperatorn. Kommandot hämtar Azure Storage-containern för det lokala utvecklarlagringskontot.

Exempel 6: Hämta flera containrar

$Context01 = New-AzStorageContext -Local 
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainer

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 kontexterna som lagras i $Context 01 och $Context 02 med hjälp av Get-AzStorageContainer.

Exempel 7: Skapa en kontext med en slutpunkt

New-AzStorageContext -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ö

New-AzStorageContext -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

$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"

Det första kommandot genererar en SAS-token med hjälp av New-AzStorageContainerSASToken cmdlet för containern med namnet 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

Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

Det här kommandot skapar en kontext med hjälp av OAuth-autentiseringen (Microsoft Entra ID).

Exempel 11: Skapa en kontext genom att ange ett lagringskontonamn, lagringskontonyckel och anpassad blobslutpunkt

New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Det här kommandot skapar en kontext för kontot myaccountname med en nyckel för kontot och en angiven blobslutpunkt.

Exempel 12: Skapa en kontext för ett anonymt lagringskonto med angiven blobslutpunkt

New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Det här kommandot skapar en kontext för anonym användning för kontot myaccountname med angiven blob-enpoint.

Exempel 13: Skapa en kontext med hjälp av en SAS-token med angivna slutpunkter

$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/"

Det första kommandot genererar en SAS-token med hjälp av cmdleten New-AzStorageContainerSASToken för containern MyContainer och lagrar sedan den token i variabeln $SasToken. Det andra kommandot skapar en kontext som använder SAS-token och en angiven blobslutpunkt, tabellslutpunkt, filslutpunkt och köslutpunkt.

Exempel 14: Skapa en kontext med hjälp av OAuth-autentiseringen med en angiven blobslutpunkt

New-AzStorageContext -UseConnectedAccount -BlobEndpoint  "https://myaccountname.blob.core.windows.net/"

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

Exempel 15: Skapa en kontext med hjälp av OAuth-autentisering på filtjänsten

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent

Det här kommandot skapar en kontext för att använda OAuth-autentiseringen (Microsoft Entra ID) på filtjänsten. Parametern "-EnableFileBackupRequestIntent" krävs för att använda OAuth-autentisering (Microsoft Entra ID) för filtjänsten. Detta kringgår alla behörighetskontroller på fil-/katalognivå och tillåter åtkomst, baserat på tillåtna dataåtgärder, även om det finns ACL:er för dessa filer/kataloger.

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

-BlobEndpoint

Tjänstslutpunkt för Azure Storage-blob

Typ:String
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

-EnableFileBackupRequestIntent

Obligatorisk parameter som ska användas med OAuth-autentisering (Microsoft Entra ID) för filer. Detta kringgår alla behörighetskontroller på fil-/katalognivå och tillåter åtkomst, baserat på tillåtna dataåtgärder, även om det finns ACL:er för dessa filer/kataloger.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
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-AzEnvironment.

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

-FileEndpoint

Tjänstslutpunkt för Azure Storage-fil

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
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

-QueueEndpoint

Tjänstslutpunkt för Azure Storage-kö

Typ:String
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

-TableEndpoint

Tjänstslutpunkt för Azure Storage-tabell

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

-UseConnectedAccount

Anger att den här cmdleten skapar en Azure Storage-kontext med OAuth-autentisering (Microsoft Entra ID). 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