New-AzStorageContext
Hiermee maakt u een Azure Storage context.
Syntax
OAuthAccount (Standaard)
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
De cmdlet New-AzStorageContext maakt een Azure Storage context.
De standaardverificatie van een opslagcontext is OAuth (Microsoft Entra ID), als alleen de naam van het opslagaccount wordt ingevoerd.
Zie de details van de verificatie van de opslagservice in .
Voorbeelden
Voorbeeld 1: Een context maken door de naam en sleutel van een opslagaccount op te geven
New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
Met deze opdracht maakt u een context voor het account met de naam ContosoGeneral dat gebruikmaakt van de opgegeven sleutel.
Voorbeeld 2: Een context maken door een connection string op te geven
New-AzStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"
Met deze opdracht maakt u een context op basis van de opgegeven connection string voor het account ContosoGeneral.
Voorbeeld 3: Een context maken voor een anoniem opslagaccount
New-AzStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"
Met deze opdracht maakt u een context voor anoniem gebruik voor het account met de naam ContosoGeneral.
De opdracht geeft HTTP op als een verbindingsprotocol.
Voorbeeld 4: Een context maken met behulp van het lokale opslagaccount voor ontwikkeling
New-AzStorageContext -Local
Met deze opdracht maakt u een context met behulp van het lokale ontwikkelopslagaccount.
De opdracht geeft de lokale parameter.
Voorbeeld 5: De container ophalen voor het lokale opslagaccount voor ontwikkelaars
New-AzStorageContext -Local | Get-AzStorageContainer
Met deze opdracht maakt u een context met behulp van het lokale opslagaccount voor ontwikkeling en geeft u vervolgens de nieuwe context door aan de cmdlet Get-AzStorageContainer met behulp van de pijplijnoperator.
Met de opdracht wordt de Azure Storage container voor het lokale opslagaccount voor ontwikkelaars ophaalt.
Voorbeeld 6: Meerdere containers ophalen
$Context01 = New-AzStorageContext -Local
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainer
Met de eerste opdracht maakt u een context met behulp van het lokale ontwikkelopslagaccount en slaat u die context vervolgens op in de variabele $Context 01.
Met de tweede opdracht maakt u een context voor het account met de naam ContosoGeneral dat gebruikmaakt van de opgegeven sleutel en slaat u die context vervolgens op in de variabele $Context 02.
Met de laatste opdracht worden de containers voor de contexten opgeslagen in $Context 01 en $Context 02 met behulp van Get-AzStorageContainer.
Voorbeeld 7: Een context maken met een eindpunt
New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"
Met deze opdracht maakt u een Azure Storage context met het opgegeven opslageindpunt.
Met de opdracht maakt u de context voor het account met de naam ContosoGeneral dat gebruikmaakt van de opgegeven sleutel.
Voorbeeld 8: Een context maken met een opgegeven omgeving
New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"
Met deze opdracht maakt u een Azure opslagcontext met de opgegeven Azure-omgeving.
Met de opdracht maakt u de context voor het account met de naam ContosoGeneral dat gebruikmaakt van de opgegeven sleutel.
Voorbeeld 9: Een context maken met behulp van een SAS-token
$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"
Met de eerste opdracht wordt een SAS-token gegenereerd met behulp van de cmdlet New-AzStorageContainerSASToken voor de container met de naam ContosoMain. Vervolgens wordt dat token opgeslagen in de variabele $SasToken.
Dit token is bedoeld voor lees-, add-, update- en verwijdermachtigingen.
Met de tweede opdracht maakt u een context voor het account met de naam ContosoGeneral dat gebruikmaakt van het SAS-token dat is opgeslagen in $SasToken en slaat u die context vervolgens op in de $Context variabele.
Met de laatste opdracht worden alle blobs weergegeven die zijn gekoppeld aan de container ContosoMain met behulp van de context die is opgeslagen in $Context.
Voorbeeld 10: Een context maken met behulp van OAuth-verificatie
Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount
Met deze opdracht maakt u een context met behulp van de OAuth-verificatie (Microsoft Entra ID).
Voorbeeld 11: Een context maken door een opslagaccountnaam, opslagaccountsleutel en aangepast blob-eindpunt op te geven
New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"
Met deze opdracht maakt u een context voor het account met de naam myaccountname met een sleutel voor het account en het opgegeven blob-eindpunt.
Voorbeeld 12: Een context maken voor een anoniem opslagaccount met een opgegeven blob-eindpunt
New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"
Met deze opdracht maakt u een context voor anoniem gebruik voor het account met de naam myaccountname, met het opgegeven blob-eindpunt.
Voorbeeld 13: Een context maken met behulp van een SAS-token met opgegeven eindpunten
$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/"
Met de eerste opdracht wordt een SAS-token gegenereerd met behulp van de cmdlet New-AzStorageContainerSASToken voor de container met de naam MyContainer. Vervolgens wordt dat token opgeslagen in de variabele $SasToken.
Met de tweede opdracht maakt u een context die gebruikmaakt van het SAS-token en een opgegeven blob-eindpunt, tabeleindpunt, bestandseindpunt en wachtrijeindpunt.
Voorbeeld 14: Een context maken met behulp van OAuth-verificatie met een opgegeven blob-eindpunt
New-AzStorageContext -UseConnectedAccount -BlobEndpoint "https://myaccountname.blob.core.windows.net/"
Met deze opdracht maakt u een context met behulp van de OAuth-verificatie met een opgegeven blob-eindpunt.
Voorbeeld 15: Een context maken met behulp van de OAuth-verificatie op bestandsservice
New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent
Met deze opdracht maakt u een context voor het gebruik van de OAuth-verificatie (Microsoft Entra ID) in de Bestandsservice.
Parameter '-EnableFileBackupRequestIntent' is vereist voor het gebruik van OAuth-verificatie (Microsoft Entra ID) voor de Bestandsservice. Hiermee worden alle machtigingscontroles op bestand-/mapniveau overgeslagen en worden toegang toegestaan, op basis van de toegestane gegevensacties, zelfs als er ACL's aanwezig zijn voor die bestanden/mappen.
Parameters
-Anonymous
Geeft aan dat deze cmdlet een Azure Storage context maakt voor anonieme aanmelding.
Parametereigenschappen
Type: SwitchParameter
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
AnonymousAccount
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AnonymousAccountEnvironment
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AnonymousAccountServiceEndpoint
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-BlobEndpoint
Azure storage blob-service-eindpunt
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
AccountNameAndKeyServiceEndpoint
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-ConnectionString
Hiermee geeft u een connection string voor de Azure Storage context.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
ConnectionString
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-EnableFileBackupRequestIntent
Vereiste parameter voor gebruik met OAuth-verificatie (Microsoft Entra ID) voor bestanden. Hiermee worden alle machtigingscontroles op bestand-/mapniveau overgeslagen en worden toegang toegestaan, op basis van de toegestane gegevensacties, zelfs als er ACL's aanwezig zijn voor die bestanden/mappen.
Parametereigenschappen
Type: SwitchParameter
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
OAuthAccount
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
OAuthAccountEnvironment
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
OAuthAccountServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-Endpoint
Hiermee geeft u het eindpunt voor de Azure Storage context.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
OAuthAccount
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AccountNameAndKey
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AnonymousAccount
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
SasToken
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-Environment
Hiermee geeft u de Azure omgeving.
De acceptabele waarden voor deze parameter zijn: AzureCloud en AzureChinaCloud.
Typ voor meer informatie .
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False Aliassen: Naam, OmgevingsNaam
Parametersets
AccountNameAndKeyEnvironment
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
AnonymousAccountEnvironment
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: True Waarde van resterende argumenten: False
-FileEndpoint
service-eindpunt voor opslagbestand Azure
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
AccountNameAndKeyServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
OAuthAccountServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
SasTokenServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AnonymousAccountServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-Local
Geeft aan dat deze cmdlet een context maakt met behulp van het lokale opslagaccount voor ontwikkeling.
Parametereigenschappen
Type: SwitchParameter
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
LocalDevelopment
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-Protocol
Transfer Protocol (https/http).
Parametereigenschappen
Type: String
Default value: None Geaccepteerde waarden: Http, Https Ondersteunt jokertekens: False DontShow: False
Parametersets
OAuthAccount
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AccountNameAndKey
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AccountNameAndKeyEnvironment
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AnonymousAccount
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AnonymousAccountEnvironment
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
SasToken
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
OAuthAccountEnvironment
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-QueueEndpoint
service-eindpunt voor Azure opslagwachtrij
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
AccountNameAndKeyServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
OAuthAccountServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
SasTokenServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AnonymousAccountServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-SasToken
Hiermee geeft u een SAS-token (Shared Access Signature) voor de context op.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
SasToken
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
SasTokenWithAzureEnvironment
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
SasTokenServiceEndpoint
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-StorageAccountKey
Hiermee geeft u een Azure Storage accountsleutel.
Met deze cmdlet maakt u een context voor de sleutel die met deze parameter wordt opgegeven.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
AccountNameAndKey
Position: 1 Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AccountNameAndKeyEnvironment
Position: 1 Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AccountNameAndKeyServiceEndpoint
Position: 1 Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-StorageAccountName
Hiermee geeft u een Azure Storage accountnaam.
Met deze cmdlet maakt u een context voor het account dat met deze parameter wordt opgegeven.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
OAuthAccount
Position: 0 Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AccountNameAndKey
Position: 0 Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AccountNameAndKeyEnvironment
Position: 0 Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AnonymousAccount
Position: 0 Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AnonymousAccountEnvironment
Position: 0 Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
SasToken
Position: 0 Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
SasTokenWithAzureEnvironment
Position: 0 Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
OAuthAccountEnvironment
Position: 0 Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AccountNameAndKeyServiceEndpoint
Position: 0 Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-TableEndpoint
service-eindpunt voor opslagtabellen Azure
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
AccountNameAndKeyServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
OAuthAccountServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
SasTokenServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
AnonymousAccountServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-UseConnectedAccount
Geeft aan dat deze cmdlet een Azure Storage context maakt met OAuth-verificatie (Microsoft Entra ID).
De cmdlet gebruikt standaard OAuth-verificatie wanneer andere verificatie niet is opgegeven.
Parametereigenschappen
Type: SwitchParameter
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
OAuthAccount
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
OAuthAccountEnvironment
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
OAuthAccountServiceEndpoint
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Uitvoerwaarden