New-AzStorageContext
Skapar en Azure Storage-kontext.
Syntax
OAuthAccount (Standard)
New-AzStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-Endpoint <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>]
AccountNameAndKey
New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
AccountNameAndKeyEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
-Environment <String>
[-Protocol <String>]
[<CommonParameters>]
AnonymousAccount
New-AzStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
AnonymousAccountEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
-Environment <String>
[-Anonymous]
[-Protocol <String>]
[<CommonParameters>]
SasToken
New-AzStorageContext
[-StorageAccountName] <String>
-SasToken <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
SasTokenWithAzureEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
-SasToken <String>
-Environment <String>
[<CommonParameters>]
OAuthAccountEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
-Environment <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>]
AccountNameAndKeyServiceEndpoint
New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
-BlobEndpoint <String>
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>]
OAuthAccountServiceEndpoint
New-AzStorageContext
[[-StorageAccountName] <String>]
[-UseConnectedAccount]
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>]
SasTokenServiceEndpoint
New-AzStorageContext
-SasToken <String>
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>]
ConnectionString
New-AzStorageContext
-ConnectionString <String>
[<CommonParameters>]
LocalDevelopment
New-AzStorageContext
[-Local]
[<CommonParameters>]
AnonymousAccountServiceEndpoint
New-AzStorageContext
[-Anonymous]
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>]
Description
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 den lokala parametern.
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 cmdleten New-AzStorageContainerSASToken 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
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 blobslutpunkt.
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.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
AnonymousAccount
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AnonymousAccountEnvironment
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AnonymousAccountServiceEndpoint
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-BlobEndpoint
Tjänstslutpunkt för Azure Storage-blob
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
AccountNameAndKeyServiceEndpoint
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-ConnectionString
Anger en anslutningssträng för Azure Storage-kontexten.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
ConnectionString
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: 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.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OAuthAccount
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
OAuthAccountEnvironment
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
OAuthAccountServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-Endpoint
Anger slutpunkten för Azure Storage-kontexten.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OAuthAccount
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AccountNameAndKey
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AnonymousAccount
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
SasToken
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: 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.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False Alias: Namn, Miljönamn
Parameteruppsättningar
AccountNameAndKeyEnvironment
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
AnonymousAccountEnvironment
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-FileEndpoint
Tjänstslutpunkt för Azure Storage-fil
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
AccountNameAndKeyServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
OAuthAccountServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
SasTokenServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AnonymousAccountServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-Local
Anger att den här cmdleten skapar en kontext med hjälp av lagringskontot för lokal utveckling.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
LocalDevelopment
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-Protocol
Transfer Protocol (https/http).
Parameteregenskaper
Typ: String
Standardvärde: None Godkända värden: Http, Https Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OAuthAccount
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AccountNameAndKey
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AccountNameAndKeyEnvironment
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AnonymousAccount
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AnonymousAccountEnvironment
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
SasToken
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
OAuthAccountEnvironment
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-QueueEndpoint
Tjänstslutpunkt för Azure Storage-kö
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
AccountNameAndKeyServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
OAuthAccountServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
SasTokenServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AnonymousAccountServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-SasToken
Anger en SAS-token (Signatur för delad åtkomst) för kontexten.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
SasToken
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
SasTokenWithAzureEnvironment
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
SasTokenServiceEndpoint
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-StorageAccountKey
Anger en Azure Storage-kontonyckel.
Den här cmdleten skapar en kontext för nyckeln som den här parametern anger.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
AccountNameAndKey
Position: 1 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AccountNameAndKeyEnvironment
Position: 1 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AccountNameAndKeyServiceEndpoint
Position: 1 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-StorageAccountName
Anger ett Azure Storage-kontonamn.
Den här cmdleten skapar en kontext för det konto som den här parametern anger.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OAuthAccount
Position: 0 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AccountNameAndKey
Position: 0 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AccountNameAndKeyEnvironment
Position: 0 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AnonymousAccount
Position: 0 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AnonymousAccountEnvironment
Position: 0 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
SasToken
Position: 0 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
SasTokenWithAzureEnvironment
Position: 0 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
OAuthAccountEnvironment
Position: 0 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AccountNameAndKeyServiceEndpoint
Position: 0 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-TableEndpoint
Tjänstslutpunkt för Azure Storage-tabell
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
AccountNameAndKeyServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
OAuthAccountServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
SasTokenServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
AnonymousAccountServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: 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.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
OAuthAccount
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
OAuthAccountEnvironment
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
OAuthAccountServiceEndpoint
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters .
Utdata
