Udostępnij za pośrednictwem

New-AzStorageShareSASToken

  • Odwołanie
Moduł:
Az.Storage

Generowanie tokenu sygnatury dostępu współdzielonego dla udziału usługi Azure Storage.

Składnia

New-AzStorageShareSASToken
   [-ShareName] <String>
   -Policy <String>
   [-Protocol <String>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzStorageShareSASToken
   [-ShareName] <String>
   [-Permission <String>]
   [-Protocol <String>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Opis

Polecenie cmdlet New-AzStorageShareSASToken generuje token sygnatury dostępu współdzielonego dla udziału usługi Azure Storage.

Przykłady

Przykład 1. Generowanie tokenu sygnatury dostępu współdzielonego dla udziału

New-AzStorageShareSASToken -ShareName "ContosoShare" -Permission "rwdl"

To polecenie tworzy token sygnatury dostępu współdzielonego dla udziału o nazwie ContosoShare.

Przykład 2. Generowanie wielu tokenów sygnatury dostępu współdzielonego przy użyciu potoku

Get-AzStorageShare -Prefix "test" | New-AzStorageShareSASToken -Permission "rwdl"

To polecenie pobiera wszystkie udziały magazynu zgodne z testem prefiksu. Polecenie przekazuje je do bieżącego polecenia cmdlet przy użyciu operatora potoku. Bieżące polecenie cmdlet tworzy token dostępu współdzielonego dla każdego udziału magazynu, który ma określone uprawnienia.

Przykład 3. Generowanie tokenu sygnatury dostępu współdzielonego korzystającego z zasad dostępu współdzielonego

New-AzStorageShareSASToken -ShareName "ContosoShare" -Policy "ContosoPolicy03"

To polecenie tworzy token sygnatury dostępu współdzielonego dla udziału magazynu o nazwie ContosoShare, który ma zasady o nazwie ContosoPolicy03.

Parametry

-Context

Określa kontekst usługi Azure Storage. Aby uzyskać kontekst, użyj polecenia cmdlet New-AzStorageContext.

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.

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

-Permission

Określa uprawnienia w tokenie, aby uzyskać dostęp do udziału i plików w ramach udziału. 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 przechowywane zasady dostępu dla udziału.

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:String
Dopuszczalne wartości:HttpsOnly, HttpsOrHttp
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ShareName

Określa nazwę udziału magazynu.

Typ:String
Aliasy:N, Name
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
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

Uwagi

  • Słowa kluczowe: common, azure, services, data, storage, blob, queue, table