New-AzStorageContext
Hiermee wordt een Azure Storage-context gemaakt.
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
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 https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.
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 verbindingsreeks 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 verbindingsreeks 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 -LocalMet 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-AzStorageContainerMet 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-AzStorageContainerMet 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" -UseConnectedAccountMet 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 opgegeven blob enpoint.
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 -EnableFileBackupRequestIntentMet 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 met deze cmdlet een Azure Storage-context wordt gemaakt voor anonieme aanmelding.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlobEndpoint
Azure Storage Blob-service-eindpunt
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionString
Hiermee geeft u een verbindingsreeks voor de Azure Storage-context.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Endpoint
Hiermee geeft u het eindpunt voor de Azure Storage-context.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Environment
Hiermee geeft u de Azure-omgeving op.
De acceptabele waarden voor deze parameter zijn: AzureCloud en AzureChinaCloud.
Typ voor meer informatie Get-Help Get-AzEnvironment.
| Type: | String |
| Aliases: | Name, EnvironmentName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-FileEndpoint
Service-eindpunt voor Azure Storage-bestanden
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Local
Geeft aan dat deze cmdlet een context maakt met behulp van het lokale opslagaccount voor ontwikkeling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
Transfer Protocol (https/http).
| Type: | String |
| Accepted values: | Http, Https |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QueueEndpoint
Service-eindpunt voor Azure Storage-wachtrij
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SasToken
Hiermee geeft u een SAS-token (Shared Access Signature) voor de context op.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountKey
Hiermee geeft u een Azure Storage-accountsleutel op. Met deze cmdlet maakt u een context voor de sleutel die met deze parameter wordt opgegeven.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountName
Hiermee geeft u een Azure Storage-accountnaam op. Met deze cmdlet maakt u een context voor het account dat met deze parameter wordt opgegeven.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TableEndpoint
Service-eindpunt voor Azure Storage-tabel
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Invoerwaarden
Uitvoerwaarden
Verwante koppelingen
Azure PowerShell
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub Issues geleidelijk uitfaseren als het feedbackmechanisme voor inhoud. Het wordt vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor