Freigeben über

New-AzStorageContext

  • Referenz
Modul:
Az.Storage

Erstellt einen Azure Storage-Kontext.

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>]

Beschreibung

Das Cmdlet New-AzStorageContext erstellt einen Azure Storage-Kontext. Die Standardauthentifizierung eines Speicherkontexts ist OAuth (Microsoft Entra ID), wenn nur der Name des Speicherkontos eingegeben wird. Details zur Authentifizierung des Speicherdiensts finden Sie unter https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.

Beispiele

Beispiel 1: Erstellen eines Kontexts durch Angeben eines Speicherkontonamens und Schlüssels

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"

Mit diesem Befehl wird ein Kontext für das Konto "ContosoGeneral" erstellt, das den angegebenen Schlüssel verwendet.

Beispiel 2: Erstellen eines Kontexts durch Angeben eines Verbindungszeichenfolge

New-AzStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"

Dieser Befehl erstellt einen Kontext basierend auf dem angegebenen Verbindungszeichenfolge für das Konto ContosoGeneral.

Beispiel 3: Erstellen eines Kontexts für ein anonymes Speicherkonto

New-AzStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"

Mit diesem Befehl wird ein Kontext für anonyme Verwendung für das Konto "ContosoGeneral" erstellt. Der Befehl gibt HTTP als Verbindungsprotokoll an.

Beispiel 4: Erstellen eines Kontexts mithilfe des lokalen Entwicklungsspeicherkontos

New-AzStorageContext -Local

Mit diesem Befehl wird ein Kontext mithilfe des lokalen Entwicklungsspeicherkontos erstellt. Der Befehl gibt den Lokalen Parameter an.

Beispiel 5: Abrufen des Containers für das lokale Entwicklerspeicherkonto

New-AzStorageContext -Local | Get-AzStorageContainer

Dieser Befehl erstellt einen Kontext mithilfe des lokalen Entwicklungsspeicherkontos und übergibt dann den neuen Kontext mithilfe des Pipelineoperators an das Cmdlet "Get-AzStorageContainer ". Der Befehl ruft den Azure Storage-Container für das lokale Entwicklerspeicherkonto ab.

Beispiel 6: Abrufen mehrerer Container

$Context01 = New-AzStorageContext -Local 
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainer

Der erste Befehl erstellt einen Kontext mithilfe des lokalen Entwicklungsspeicherkontos und speichert diesen Kontext dann in der variablen $Context 01. Der zweite Befehl erstellt einen Kontext für das Konto "ContosoGeneral", das den angegebenen Schlüssel verwendet, und speichert diesen Kontext dann in der variablen $Context 02. Der letzte Befehl ruft die Container für die in $Context 01 und $Context 02 gespeicherten Kontexte mithilfe von Get-AzStorageContainer ab.

Beispiel 7: Erstellen eines Kontexts mit einem Endpunkt

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"

Dieser Befehl erstellt einen Azure Storage-Kontext mit dem angegebenen Speicherendpunkt. Der Befehl erstellt den Kontext für das Konto "ContosoGeneral", das den angegebenen Schlüssel verwendet.

Beispiel 8: Erstellen eines Kontexts mit einer angegebenen Umgebung

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"

Mit diesem Befehl wird ein Azure-Speicherkontext erstellt, der über die angegebene Azure-Umgebung verfügt. Der Befehl erstellt den Kontext für das Konto "ContosoGeneral", das den angegebenen Schlüssel verwendet.

Beispiel 9: Erstellen eines Kontexts mithilfe eines SAS-Tokens

$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"

Der erste Befehl generiert ein SAS-Token mithilfe des Cmdlets New-AzStorageContainerSASToken für den Container "ContosoMain" und speichert dieses Token dann in der $SasToken Variablen. Dieses Token dient zum Lesen, Hinzufügen, Aktualisieren und Löschen von Berechtigungen. Der zweite Befehl erstellt einen Kontext für das Konto "ContosoGeneral", das das in $SasToken gespeicherte SAS-Token verwendet, und speichert diesen Kontext dann in der $Context Variablen. Der letzte Befehl listet alle Blobs auf, die dem Container "ContosoMain" zugeordnet sind, indem der in $Context gespeicherte Kontext verwendet wird.

Beispiel 10: Erstellen eines Kontexts mithilfe der OAuth-Authentifizierung

Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

Mit diesem Befehl wird ein Kontext mithilfe der OAuth-Authentifizierung (Microsoft Entra ID) erstellt.

Beispiel 11: Erstellen eines Kontexts durch Angeben eines Speicherkontonamens, Speicherkontoschlüssels und benutzerdefinierten BLOB-Endpunkts

New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Dieser Befehl erstellt einen Kontext für das Konto mit dem Namen "myaccountname" mit einem Schlüssel für das Konto und dem angegebenen BLOB-Endpunkt.

Beispiel 12: Erstellen eines Kontexts für ein anonymes Speicherkonto mit angegebenem BLOB-Endpunkt

New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Dieser Befehl erstellt einen Kontext für anonyme Verwendung für das Konto mit dem Namen "myaccountname" mit angegebenem BLOB-Enpoint.

Beispiel 13: Erstellen eines Kontexts mithilfe eines SAS-Tokens mit angegebenen Endpunkten

$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/"

Der erste Befehl generiert ein SAS-Token mithilfe des Cmdlets New-AzStorageContainerSASToken für den Container mit dem Namen "MyContainer" und speichert dieses Token dann in der $SasToken Variablen. Der zweite Befehl erstellt einen Kontext, der das SAS-Token und einen angegebenen Blob-Endpunkt, Tabellenendpunkt, Dateiendpunkt und Warteschlangenendpunkt verwendet.

Beispiel 14: Erstellen eines Kontexts mithilfe der OAuth-Authentifizierung mit einem angegebenen Blob-Endpunkt

New-AzStorageContext -UseConnectedAccount -BlobEndpoint  "https://myaccountname.blob.core.windows.net/"

Dieser Befehl erstellt einen Kontext mithilfe der OAuth-Authentifizierung mit einem angegebenen Blob-Endpunkt.

Beispiel 15: Erstellen eines Kontexts mithilfe der OAuth-Authentifizierung im Dateidienst

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent

Dieser Befehl erstellt einen Kontext zur Verwendung der OAuth-Authentifizierung (Microsoft Entra ID) für den Dateidienst. Der Parameter "-EnableFileBackupRequestIntent" ist erforderlich, um die OAuth-Authentifizierung (Microsoft Entra ID) für den Dateidienst zu verwenden. Dadurch werden alle Berechtigungsprüfungen auf Datei-/Verzeichnisebene umgangen und der Zugriff basierend auf den zulässigen Datenaktionen zugelassen, auch wenn ACLs für diese Dateien/Verzeichnisse vorhanden sind.

Parameter

-Anonymous

Gibt an, dass dieses Cmdlet einen Azure Storage-Kontext für die anonyme Anmeldung erstellt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BlobEndpoint

Azure Storage Blob-Dienstendpunkt

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConnectionString

Gibt einen Verbindungszeichenfolge für den Azure Storage-Kontext an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableFileBackupRequestIntent

Erforderlicher Parameter für die Verwendung mit der OAuth-Authentifizierung (Microsoft Entra ID) für Dateien. Dadurch werden alle Berechtigungsprüfungen auf Datei-/Verzeichnisebene umgangen und der Zugriff basierend auf den zulässigen Datenaktionen zugelassen, auch wenn ACLs für diese Dateien/Verzeichnisse vorhanden sind.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Endpoint

Gibt den Endpunkt für den Azure Storage-Kontext an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Environment

Gibt die Azure-Umgebung an. Die zulässigen Werte für diesen Parameter sind: AzureCloud und AzureChinaCloud. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-AzEnvironment.

Typ:String
Aliase:Name, EnvironmentName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-FileEndpoint

Azure Storage File Service Endpoint

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Local

Gibt an, dass dieses Cmdlet einen Kontext mithilfe des lokalen Entwicklungsspeicherkontos erstellt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Protocol

Transferprotokoll (https/http).

Typ:String
Zulässige Werte:Http, Https
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-QueueEndpoint

Endpunkt des Azure-Speicherwarteschlangendiensts

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SasToken

Gibt ein SAS-Token (Shared Access Signature) für den Kontext an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StorageAccountKey

Gibt einen Azure Storage-Kontoschlüssel an. Dieses Cmdlet erstellt einen Kontext für den Schlüssel, den dieser Parameter angibt.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StorageAccountName

Gibt einen Azure Storage-Kontonamen an. Dieses Cmdlet erstellt einen Kontext für das Konto, das dieser Parameter angibt.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TableEndpoint

Azure Storage Table Service Endpoint

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseConnectedAccount

Gibt an, dass dieses Cmdlet einen Azure Storage-Kontext mit der OAuth-Authentifizierung (Microsoft Entra ID) erstellt. Das Cmdlet verwendet standardmäßig die OAuth-Authentifizierung, wenn keine andere Authentifizierung angegeben ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Ausgaben

AzureStorageContext