New-AzureStorageContext
Erstellt einen Azure Storage-Kontext.
Warnung
Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.
Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.
Syntax
New-AzureStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
-Environment <String>
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
-Environment <String>
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
-SasToken <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
-SasToken <String>
-Environment <String>
[<CommonParameters>] New-AzureStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
-Environment <String>
[<CommonParameters>] New-AzureStorageContext
-ConnectionString <String>
[<CommonParameters>] New-AzureStorageContext
[-Local]
[<CommonParameters>] Beschreibung
Das Cmdlet New-AzureStorageContext erstellt einen Azure Storage-Kontext.
Beispiele
Beispiel 1: Erstellen eines Kontexts durch Angeben eines Speicherkontonamens und Schlüssels
C:\PS>New-AzureStorageContext -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
C:\PS>New-AzureStorageContext -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
C:\PS>New-AzureStorageContext -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
C:\PS>New-AzureStorageContext -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
C:\PS>New-AzureStorageContext -Local | Get-AzureStorageContainerDieser Befehl erstellt einen Kontext mithilfe des lokalen Entwicklungsspeicherkontos und übergibt dann den neuen Kontext mithilfe des Pipelineoperators an das Cmdlet "Get-AzureStorageContainer ". Der Befehl ruft den Azure Storage-Container für das lokale Entwicklerspeicherkonto ab.
Beispiel 6: Abrufen mehrerer Container
C:\PS>$Context01 = New-AzureStorageContext -Local
PS C:\> $Context02 = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
PS C:\> ($Context01, $Context02) | Get-AzureStorageContainerDer 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-AzureStorageContainer ab.
Beispiel 7: Erstellen eines Kontexts mit einem Endpunkt
C:\PS>New-AzureStorageContext -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
C:\PS>New-AzureStorageContext -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
C:\PS>$SasToken = New-AzureStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
PS C:\> $Context = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
PS C:\> $Context | Get-AzureStorageBlob -Container "ContosoMain"Der erste Befehl generiert ein SAS-Token mithilfe des Cmdlets New-AzureStorageContainerSASToken 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
C:\PS>Connect-AzureRmAccount
C:\PS> $Context = New-AzureStorageContext -StorageAccountName "myaccountname" -UseConnectedAccountMit diesem Befehl wird ein Kontext mithilfe der OAuth-Authentifizierung erstellt.
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 |
-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 |
-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-AzureEnvironment.
| Typ: | String |
| Aliase: | Name, EnvironmentName |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| 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 |
-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 |
-UseConnectedAccount
Gibt an, dass dieses Cmdlet einen Azure Storage-Kontext mit OAuth-Authentifizierung 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 |