New-AzStorageContext
Tworzy kontekst usługi Azure Storage.
Składnia
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>] Opis
Polecenie cmdlet New-AzStorageContext tworzy kontekst usługi Azure Storage. Domyślne uwierzytelnianie kontekstu magazynu to OAuth (Microsoft Entra ID), jeśli tylko wprowadź nazwę konta magazynu. Zobacz szczegóły uwierzytelniania usługi Storage w programie https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.
Przykłady
Przykład 1. Tworzenie kontekstu przez określenie nazwy i klucza konta magazynu
New-AzStorageContext -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
New-AzStorageContext -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
New-AzStorageContext -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
New-AzStorageContext -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
New-AzStorageContext -Local | Get-AzStorageContainerTo polecenie tworzy kontekst przy użyciu lokalnego konta magazynu programistycznego, a następnie przekazuje nowy kontekst do polecenia cmdlet Get-AzStorageContainer 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
$Context01 = New-AzStorageContext -Local
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainerPierwsze 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-AzStorageContainer.
Przykład 7. Tworzenie kontekstu z punktem końcowym
New-AzStorageContext -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
New-AzStorageContext -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
$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"Pierwsze polecenie generuje token SAS przy użyciu polecenia cmdlet New-AzStorageContainerSASToken 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
Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccountTo polecenie tworzy kontekst przy użyciu uwierzytelniania OAuth (Microsoft Entra ID).
Przykład 11: Tworzenie kontekstu przez określenie nazwy konta magazynu, klucza konta magazynu i niestandardowego punktu końcowego obiektu blob
New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"To polecenie tworzy kontekst dla konta o nazwie myaccountname z kluczem dla konta i określonym punktem końcowym obiektu blob.
Przykład 12: Tworzenie kontekstu dla anonimowego konta magazynu z określonym punktem końcowym obiektu blob
New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"To polecenie tworzy kontekst do użycia anonimowego dla konta o nazwie myaccountname z określonym punktem blob.
Przykład 13: Tworzenie kontekstu przy użyciu tokenu SAS z określonymi punktami końcowymi
$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/"Pierwsze polecenie generuje token SAS przy użyciu polecenia cmdlet New-AzStorageContainerSASToken dla kontenera o nazwie MyContainer, a następnie przechowuje ten token w zmiennej $SasToken. Drugie polecenie tworzy kontekst, który używa tokenu SAS i określonego punktu końcowego obiektu blob, punktu końcowego tabeli, punktu końcowego pliku i punktu końcowego kolejki.
Przykład 14: Tworzenie kontekstu przy użyciu uwierzytelniania OAuth z określonym punktem końcowym obiektu blob
New-AzStorageContext -UseConnectedAccount -BlobEndpoint "https://myaccountname.blob.core.windows.net/"To polecenie tworzy kontekst przy użyciu uwierzytelniania OAuth z określonym punktem końcowym obiektu blob.
Przykład 15: Tworzenie kontekstu przy użyciu uwierzytelniania OAuth w usłudze plików
New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntentTo polecenie tworzy kontekst do korzystania z uwierzytelniania OAuth (Microsoft Entra ID) w usłudze plików. Parametr "-EnableFileBackupRequestIntent" jest wymagany do korzystania z uwierzytelniania OAuth (Microsoft Entra ID) dla usługi plików. Spowoduje to obejście wszystkich kontroli uprawnień na poziomie pliku/katalogu i zezwolenie na dostęp na podstawie dozwolonych akcji danych, nawet jeśli istnieją listy ACL dla tych plików/katalogów.
Parametry
-Anonymous
Wskazuje, że to polecenie cmdlet tworzy kontekst usługi Azure Storage na potrzeby logowania anonimowego.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlobEndpoint
Punkt końcowy usługi Azure Storage Blob Service
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionString
Określa parametry połączenia kontekstu usługi Azure Storage.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableFileBackupRequestIntent
Wymagany parametr do użycia z uwierzytelnianiem OAuth (Microsoft Entra ID) dla plików. Spowoduje to obejście wszystkich kontroli uprawnień na poziomie pliku/katalogu i zezwolenie na dostęp na podstawie dozwolonych akcji danych, nawet jeśli istnieją listy ACL dla tych plików/katalogów.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Endpoint
Określa punkt końcowy kontekstu usługi Azure Storage.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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-AzEnvironment.
| Type: | String |
| Aliases: | Name, EnvironmentName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-FileEndpoint
Punkt końcowy usługi plików usługi Azure Storage
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Local
Wskazuje, że to polecenie cmdlet tworzy kontekst przy użyciu lokalnego konta magazynu programistycznego.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
Protokół transferu (https/http).
| Type: | String |
| Accepted values: | Http, Https |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QueueEndpoint
Punkt końcowy usługi kolejki usługi Azure Storage
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SasToken
Określa token sygnatury dostępu współdzielonego (SAS) dla kontekstu.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountKey
Określa klucz konta usługi Azure Storage. To polecenie cmdlet tworzy kontekst klucza, który określa ten parametr.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountName
Określa nazwę konta usługi Azure Storage. To polecenie cmdlet tworzy kontekst dla konta, które określa ten parametr.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TableEndpoint
Punkt końcowy usługi tabel usługi Azure Storage
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseConnectedAccount
Wskazuje, że to polecenie cmdlet tworzy kontekst usługi Azure Storage z uwierzytelnianiem OAuth (Microsoft Entra ID). Polecenie cmdlet będzie domyślnie używać uwierzytelniania OAuth, gdy nie określono innego uwierzytelniania.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Dane wejściowe
Dane wyjściowe
Linki powiązane
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla