New-AzStorageContext
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 -LocalMit 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-AzStorageContainerDieser 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-AzStorageContainerDer 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" -UseConnectedAccountMit 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 -EnableFileBackupRequestIntentDieser 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlobEndpoint
Azure Storage Blob-Dienstendpunkt
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionString
Gibt einen Verbindungszeichenfolge für den Azure Storage-Kontext an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Endpoint
Gibt den Endpunkt für den Azure Storage-Kontext an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Aliases: | Name, EnvironmentName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-FileEndpoint
Azure Storage File Service Endpoint
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Local
Gibt an, dass dieses Cmdlet einen Kontext mithilfe des lokalen Entwicklungsspeicherkontos erstellt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
Transferprotokoll (https/http).
| Type: | String |
| Accepted values: | Http, Https |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QueueEndpoint
Endpunkt des Azure-Speicherwarteschlangendiensts
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SasToken
Gibt ein SAS-Token (Shared Access Signature) für den Kontext an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountKey
Gibt einen Azure Storage-Kontoschlüssel an. Dieses Cmdlet erstellt einen Kontext für den Schlüssel, den dieser Parameter angibt.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountName
Gibt einen Azure Storage-Kontonamen an. Dieses Cmdlet erstellt einen Kontext für das Konto, das dieser Parameter angibt.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TableEndpoint
Azure Storage Table Service Endpoint
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Ausgaben
Ähnliche Themen
Azure PowerShell
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für