New-AzStorageContext

Module:

Az.Storage

Hiermee wordt een Azure Storage-context gemaakt.

Syntaxis

PowerShell

New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]

PowerShell

New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]

PowerShell

New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]

PowerShell

New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]

PowerShell

New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]

PowerShell

New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   -Environment <String>
   [<CommonParameters>]

PowerShell

New-AzStorageContext
   -ConnectionString <String>
   [<CommonParameters>]

PowerShell

New-AzStorageContext
   [-Local]
   [<CommonParameters>]

Description

De cmdlet New-AzStorageContext maakt een Azure Storage-context.

Voorbeelden

Voorbeeld 1: Een context maken door de naam en sleutel van een opslagaccount op te geven

PowerShell

C:\PS>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

PowerShell

C:\PS>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

PowerShell

C:\PS>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

PowerShell

C:\PS>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

PowerShell

C:\PS>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

PowerShell

C:\PS>$Context01 = New-AzStorageContext -Local
PS C:\> $Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
PS C:\> ($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

PowerShell

C:\PS>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

PowerShell

C:\PS>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

PowerShell

C:\PS>$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
PS C:\> $Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
PS C:\> $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.

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

-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

-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-AzureEnvironment.

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

-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

Invoerwaarden

String

Uitvoerwaarden

AzureStorageContext

Verwante koppelingen

• Verkrijg-AzStorageBlob
• New-AzStorageContainerSASToken