Udostępnij za pośrednictwem

New-AzureStorageContainerSASToken

  • Odwołanie
Moduł:
Azure.Storage

Generuje token SAS dla kontenera 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-AzureStorageContainerSASToken
   [-Name] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureStorageContainerSASToken
   [-Name] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Opis

Polecenie cmdlet New-AzureStorageContainerSASToken generuje token sygnatury dostępu współdzielonego (SAS) dla kontenera usługi Azure Storage.

Przykłady

Przykład 1. Generowanie tokenu SAS kontenera z pełnym uprawnieniem kontenera

PS C:\>New-AzureStorageContainerSASToken -Name "Test" -Permission rwdl

W tym przykładzie jest generowany token SAS kontenera z pełnymi uprawnieniami kontenera.

Przykład 2. Generowanie wielu tokenów SAS kontenera według potoku

PS C:\>Get-AzureStorageContainer -Container test* | New-AzureStorageContainerSASToken -Permission rwdl

W tym przykładzie jest generowanych wiele tokenów SAS kontenera przy użyciu potoku.

Przykład 3. Generowanie tokenu SAS kontenera przy użyciu zasad dostępu współdzielonego

PS C:\>New-AzureStorageContainerSASToken -Name "Test" -Policy "PolicyName"

W tym przykładzie jest generowany token SAS kontenera z zasadami dostępu współdzielonego.

Parametry

-Context

Określa kontekst usługi Azure Storage. Można go utworzyć przy użyciu polecenia cmdlet New-AzureStorageContext.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ExpiryTime

Określa czas, w którym sygnatura dostępu współdzielonego staje się nieprawidłowa. Jeśli użytkownik ustawi godzinę rozpoczęcia, ale nie czas wygaśnięcia, czas wygaśnięcia jest ustawiony na godzinę rozpoczęcia i jedną godzinę. Jeśli nie określono ani godziny rozpoczęcia, ani czasu wygaśnięcia, czas wygaśnięcia jest ustawiony na bieżący czas plus jedną godzinę.

Typ:Nullable<T>[DateTime]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FullUri

Wskazuje, że to polecenie cmdlet zwraca pełny identyfikator URI obiektu blob i token sygnatury dostępu współdzielonego.

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

-IPAddressOrRange

Określa adres IP lub zakres adresów IP, z których mają być akceptowane żądania, takie jak 168.1.5.65 lub 168.1.5.60-168.1.5.70. Zakres jest inkluzywny.

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

-Name

Określa nazwę kontenera usługi Azure Storage.

Typ:String
Aliasy:N, Container
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Permission

Określa uprawnienia dla kontenera magazynu. Należy pamiętać, że jest to ciąg, taki jak rwd (w przypadku odczytu, zapisu i usuwania).

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

-Policy

Określa zasady dostępu przechowywanego na platformie Azure.

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

-Protocol

Określa protokół dozwolony dla żądania. Dopuszczalne wartości tego parametru to:

  • HttpsOnly
  • HttpsOrHttp Wartość domyślna to HttpsOrHttp.
Typ:Nullable<T>[SharedAccessProtocol]
Dopuszczalne wartości:HttpsOnly, HttpsOrHttp
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-StartTime

Określa czas, w którym sygnatura dostępu współdzielonego staje się prawidłowa.

Typ:Nullable<T>[DateTime]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

IStorageContext

Dane wyjściowe

String