New-AzStorageBlobSASToken

Moduł:

Az.Storage Module

Generuje token SAS dla obiektu blob usługi Azure Storage.

Składnia

BlobNameWithPermission (domyślnie)

New-AzStorageBlobSASToken
    [-Container] <String>
    [-Blob] <String>
    [-Permission <String>]
    [-Protocol <SharedAccessProtocol>]
    [-IPAddressOrRange <String>]
    [-StartTime <DateTime>]
    [-ExpiryTime <DateTime>]
    [-FullUri]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobPipelineWithPolicy

New-AzStorageBlobSASToken
    -CloudBlob <CloudBlob>
    -Policy <String>
    [-BlobBaseClient <BlobBaseClient>]
    [-Protocol <SharedAccessProtocol>]
    [-IPAddressOrRange <String>]
    [-StartTime <DateTime>]
    [-ExpiryTime <DateTime>]
    [-FullUri]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobPipelineWithPermission

New-AzStorageBlobSASToken
    -CloudBlob <CloudBlob>
    [-BlobBaseClient <BlobBaseClient>]
    [-Permission <String>]
    [-Protocol <SharedAccessProtocol>]
    [-IPAddressOrRange <String>]
    [-StartTime <DateTime>]
    [-ExpiryTime <DateTime>]
    [-FullUri]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobNameWithPolicy

New-AzStorageBlobSASToken
    [-Container] <String>
    [-Blob] <String>
    -Policy <String>
    [-Protocol <SharedAccessProtocol>]
    [-IPAddressOrRange <String>]
    [-StartTime <DateTime>]
    [-ExpiryTime <DateTime>]
    [-FullUri]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

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

Przykłady

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

New-AzStorageBlobSASToken -Container "ContainerName" -Blob "BlobName" -Permission rwd

W tym przykładzie generowany jest token SAS obiektu blob z pełnym uprawnieniem do obiektu blob.

Przykład 2. Generowanie tokenu SAS obiektu blob z czasem życia

$StartTime = Get-Date
$EndTime = $startTime.AddHours(2.0)
New-AzStorageBlobSASToken -Container "ContainerName" -Blob "BlobName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime

W tym przykładzie jest generowany token SAS obiektu blob z czasem życia.

Przykład 3. Generowanie tokenu SAS tożsamości użytkownika z kontekstem magazynu na podstawie uwierzytelniania OAuth

$ctx = New-AzStorageContext -StorageAccountName $accountName -UseConnectedAccount
$StartTime = Get-Date
$EndTime = $startTime.AddDays(6)
New-AzStorageBlobSASToken -Container "ContainerName" -Blob "BlobName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime -Context $ctx

W tym przykładzie jest generowany token SAS tożsamości użytkownika z kontekstem magazynu na podstawie uwierzytelniania OAuth

Parametry

-Blob

Określa nazwę obiektu blob magazynu.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

BlobNameWithPermission

Position:	1
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

BlobNameWithPolicy

Position:	1
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-BlobBaseClient

Obiekt BlobBaseClient

Właściwości parametru

Typ:	BlobBaseClient
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

BlobPipelineWithPolicy

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

BlobPipelineWithPermission

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-CloudBlob

Określa obiekt CloudBlob . Aby uzyskać obiekt CloudBlob , użyj polecenia cmdlet Get-AzStorageBlob .

Właściwości parametru

Typ:	Microsoft.Azure.Storage.Blob.CloudBlob
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	ICloudBlob

Zestawy parametrów

BlobPipelineWithPolicy

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

BlobPipelineWithPermission

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	por

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Container

Określa nazwę kontenera magazynu.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

BlobNameWithPermission

Position:	0
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

BlobNameWithPolicy

Position:	0
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Context

Określa kontekst magazynu. Gdy kontekst magazynu jest oparty na uwierzytelnianiu OAuth, wygeneruje token SAS obiektu blob tożsamości użytkownika.

Właściwości parametru

Typ:	IStorageContext
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-DefaultProfile

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

Właściwości parametru

Typ:	IAzureContextContainer
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	AzureRmContext, AzureCredential

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-EncryptionScope

Zakres szyfrowania do użycia podczas wysyłania żądań autoryzowanych za pomocą tego identyfikatora URI sygnatury dostępu współdzielonego.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-ExpiryTime

Określa, kiedy sygnatura dostępu współdzielonego wygaśnie. Gdy kontekst magazynu jest oparty na uwierzytelnianiu OAuth, czas wygaśnięcia musi być w ciągu 7 dni od bieżącego czasu i nie może być wcześniejszy niż bieżący czas.

Właściwości parametru

Typ:	Nullable<T>[DateTime]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-FullUri

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

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Permission

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

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

BlobNameWithPermission

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

BlobPipelineWithPermission

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Policy

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

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

BlobPipelineWithPolicy

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

BlobNameWithPolicy

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Protocol

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

• HttpsOnly
• HttpsOrHttp Wartość domyślna to HttpsOrHttp.

Właściwości parametru

Typ:	Nullable<T>[Microsoft.Azure.Storage.SharedAccessProtocol]
Domyślna wartość:	None
Dopuszczalne wartości:	HttpsOnly, HttpsOrHttp
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-StartTime

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

Właściwości parametru

Typ:	Nullable<T>[DateTime]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Wi

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

Dane wyjściowe

String

Linki powiązane

• Get-AzStorageBlob
• New-AzStorageContainerSASToken