Udostępnij za pośrednictwem

New-AzStorageContext

  • Odwołanie
Moduł:
Az.Storage

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 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 parametrów połączenia

New-AzStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"

To polecenie tworzy kontekst na podstawie określonych parametrów 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 -Local

To polecenie tworzy kontekst przy użyciu lokalnego konta magazynu programistycznego. Polecenie określa parametr Local.

Przykład 5. Pobieranie kontenera dla lokalnego konta magazynu deweloperów

New-AzStorageContext -Local | Get-AzStorageContainer

To polecenie tworzy kontekst przy użyciu lokalnego konta magazynu programistycznego, a następnie przekazuje nowy kontekst do Get-AzStorageContainer polecenia cmdlet 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-AzStorageContainer

Pierwsze 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. Ostatnie polecenie pobiera kontenery dla kontekstów przechowywanych w $Context 01 i $Context 02 przy użyciu 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" -UseConnectedAccount

To 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 -EnableFileBackupRequestIntent

To 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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-BlobEndpoint

Punkt końcowy usługi Azure Storage Blob Service

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ConnectionString

Określa parametry połączenia dla 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

-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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
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-AzEnvironment.

Typ:String
Aliasy:Name, EnvironmentName
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-FileEndpoint

Punkt końcowy usługi plików usługi Azure Storage

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
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

-QueueEndpoint

Punkt końcowy usługi kolejki usługi Azure Storage

Typ:String
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

-TableEndpoint

Punkt końcowy usługi tabel usługi Azure Storage

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
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 (Microsoft Entra ID). Polecenie cmdlet będzie domyślnie używać uwierzytelniania OAuth, gdy nie określono innego uwierzytelniania.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Dane wyjściowe

AzureStorageContext