Delen via

New-AzStorageContext

  • Referentie
Module:
Az.Storage

Hiermee wordt een Azure Storage-context gemaakt.

Syntaxis

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 -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 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 -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 met deze cmdlet een Azure Storage-context wordt gemaakt voor anonieme aanmelding.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BlobEndpoint

Azure Storage Blob-service-eindpunt

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConnectionString

Hiermee geeft u een verbindingsreeks voor de Azure Storage-context.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Endpoint

Hiermee geeft u het eindpunt voor de Azure Storage-context.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Aliassen:Name, EnvironmentName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-FileEndpoint

Service-eindpunt voor Azure Storage-bestanden

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Protocol

Transfer Protocol (https/http).

Type:String
Geaccepteerde waarden:Http, Https
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-QueueEndpoint

Service-eindpunt voor Azure Storage-wachtrij

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SasToken

Hiermee geeft u een SAS-token (Shared Access Signature) voor de context op.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TableEndpoint

Service-eindpunt voor Azure Storage-tabel

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Uitvoerwaarden

AzureStorageContext