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 weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. 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 |