New-AzureStorageContext
Tworzy kontekst usługi Azure Storage.
Ostrzeżenie
Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.
Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.
Składnia
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>] Opis
Polecenie cmdlet New-AzureStorageContext tworzy kontekst usługi Azure Storage.
Przykłady
Przykład 1. Tworzenie kontekstu przez określenie nazwy i klucza konta magazynu
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"To polecenie tworzy kontekst dla konta o nazwie ContosoGeneral, który używa określonego klucza.
Przykład 2. Tworzenie kontekstu przez określenie parametry połączenia
C:\PS>New-AzureStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"To polecenie tworzy kontekst na podstawie określonego parametry połączenia dla konta ContosoGeneral.
Przykład 3. Tworzenie kontekstu dla anonimowego konta magazynu
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"To polecenie tworzy kontekst do użycia anonimowego dla konta o nazwie ContosoGeneral. Polecenie określa protokół HTTP jako protokół połączenia.
Przykład 4. Tworzenie kontekstu przy użyciu lokalnego konta magazynu programistycznego
C:\PS>New-AzureStorageContext -LocalTo polecenie tworzy kontekst przy użyciu lokalnego konta magazynu programistycznego. Polecenie określa parametr Lokalny .
Przykład 5. Pobieranie kontenera dla lokalnego konta magazynu deweloperów
C:\PS>New-AzureStorageContext -Local | Get-AzureStorageContainerTo polecenie tworzy kontekst przy użyciu lokalnego konta magazynu programistycznego, a następnie przekazuje nowy kontekst do polecenia cmdlet Get-AzureStorageContainer przy użyciu operatora potoku. Polecenie pobiera kontener usługi Azure Storage dla lokalnego konta magazynu deweloperów.
Przykład 6. Pobieranie wielu kontenerów
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-AzureStorageContainerPierwsze polecenie tworzy kontekst przy użyciu lokalnego konta magazynu programistycznego, a następnie przechowuje ten kontekst w zmiennej $Context 01. Drugie polecenie tworzy kontekst dla konta o nazwie ContosoGeneral, który używa określonego klucza, a następnie przechowuje ten kontekst w zmiennej $Context 02. Końcowe polecenie pobiera kontenery dla kontekstów przechowywanych w $Context 01 i $Context 02 przy użyciu polecenia Get-AzureStorageContainer.
Przykład 7. Tworzenie kontekstu z punktem końcowym
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"To polecenie tworzy kontekst usługi Azure Storage, który ma określony punkt końcowy magazynu. Polecenie tworzy kontekst konta o nazwie ContosoGeneral, który używa określonego klucza.
Przykład 8. Tworzenie kontekstu z określonym środowiskiem
C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"To polecenie tworzy kontekst usługi Azure Storage, który ma określone środowisko platformy Azure. Polecenie tworzy kontekst konta o nazwie ContosoGeneral, który używa określonego klucza.
Przykład 9. Tworzenie kontekstu przy użyciu tokenu SAS
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"Pierwsze polecenie generuje token SAS przy użyciu polecenia cmdlet New-AzureStorageContainerSASToken dla kontenera o nazwie ContosoMain, a następnie przechowuje ten token w zmiennej $SasToken. Ten token jest przeznaczony do odczytu, dodawania, aktualizowania i usuwania uprawnień. Drugie polecenie tworzy kontekst dla konta o nazwie ContosoGeneral, który używa tokenu SAS przechowywanego w $SasToken, a następnie przechowuje ten kontekst w zmiennej $Context. Ostatnie polecenie wyświetla listę wszystkich obiektów blob skojarzonych z kontenerem o nazwie ContosoMain przy użyciu kontekstu przechowywanego w $Context.
Przykład 10: Tworzenie kontekstu przy użyciu uwierzytelniania OAuth
C:\PS>Connect-AzureRmAccount
C:\PS> $Context = New-AzureStorageContext -StorageAccountName "myaccountname" -UseConnectedAccountTo polecenie tworzy kontekst przy użyciu uwierzytelniania OAuth.
Parametry
-Anonymous
Wskazuje, że to polecenie cmdlet tworzy kontekst usługi Azure Storage na potrzeby logowania anonimowego.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ConnectionString
Określa parametry połączenia kontekstu usługi Azure Storage.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Endpoint
Określa punkt końcowy kontekstu usługi Azure Storage.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Environment
Określa środowisko platformy Azure.
Dopuszczalne wartości tego parametru to: AzureCloud i AzureChinaCloud.
Aby uzyskać więcej informacji, wpisz Get-Help Get-AzureEnvironment.
| Typ: | String |
| Aliasy: | Name, EnvironmentName |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Local
Wskazuje, że to polecenie cmdlet tworzy kontekst przy użyciu lokalnego konta magazynu programistycznego.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Protocol
Protokół transferu (https/http).
| Typ: | String |
| Dopuszczalne wartości: | Http, Https |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-SasToken
Określa token sygnatury dostępu współdzielonego (SAS) dla kontekstu.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-StorageAccountKey
Określa klucz konta usługi Azure Storage. To polecenie cmdlet tworzy kontekst klucza, który określa ten parametr.
| Typ: | String |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-StorageAccountName
Określa nazwę konta usługi Azure Storage. To polecenie cmdlet tworzy kontekst dla konta, które określa ten parametr.
| Typ: | String |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-UseConnectedAccount
Wskazuje, że to polecenie cmdlet tworzy kontekst usługi Azure Storage z uwierzytelnianiem OAuth. Polecenie cmdlet będzie domyślnie używać uwierzytelniania OAuth, gdy inne uwierzytelnianie nie zostanie określone.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |