Delen via


New-AzStorageBlobSASToken

Hiermee genereert u een SAS-token voor een Azure Storage-blob.

Syntaxis

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

Description

De cmdlet New-AzStorageBlobSASToken genereert een SAS-token (Shared Access Signature) voor een Azure Storage-blob.

Voorbeelden

Voorbeeld 1: Een BLOB SAS-token genereren met volledige blobmachtiging

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

In dit voorbeeld wordt een BLOB SAS-token gegenereerd met een volledige blobmachtiging.

Voorbeeld 2: Een BLOB SAS-token genereren met levensduur

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

In dit voorbeeld wordt een BLOB SAS-token gegenereerd met levensduur.

Voorbeeld 3: Een SAS-token voor gebruikersidentiteit genereren met opslagcontext op basis van OAuth-verificatie

$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

In dit voorbeeld wordt een SAS-token voor de gebruikersidentiteit gegenereerd met opslagcontext op basis van OAuth-verificatie

Parameters

-Blob

Hiermee geeft u de naam van de opslagblob op.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BlobBaseClient

BlobBaseClient-object

Type:BlobBaseClient
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-CloudBlob

Hiermee geeft u het CloudBlob-object . Gebruik de cmdlet Get-AzStorageBlob om een CloudBlob-object te verkrijgen.

Type:CloudBlob
Aliassen:ICloudBlob
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Container

Hiermee geeft u de naam van de opslagcontainer op.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Context

Hiermee geeft u de opslagcontext op. Wanneer de opslagcontext is gebaseerd op OAuth-verificatie, wordt er een SAS-token voor de gebruikersidentiteit gegenereerd.

Type:IStorageContext
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EncryptionScope

Versleutelingsbereik dat moet worden gebruikt bij het verzenden van aanvragen die zijn geautoriseerd met deze SAS-URI.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ExpiryTime

Hiermee geeft u op wanneer de handtekening voor gedeelde toegang verloopt. Wanneer de opslagcontext is gebaseerd op OAuth-verificatie, moet de verlooptijd binnen 7 dagen na de huidige tijd vallen en mag deze niet eerder zijn dan de huidige tijd.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FullUri

Geeft aan dat deze cmdlet de volledige blob-URI en het shared access signature-token retourneert.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IPAddressOrRange

Hiermee geeft u het IP-adres of bereik van IP-adressen waaruit aanvragen moeten worden geaccepteerd, zoals 168.1.5.65 of 168.1.5.60-168.1.5.70. Het bereik is inclusief.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Permission

Hiermee geeft u de machtigingen voor een opslagblob op. Het is belangrijk om te weten dat dit een tekenreeks is, zoals rwd (voor lezen, schrijven en verwijderen).

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Policy

Hiermee geeft u een opgeslagen toegangsbeleid voor Azure op.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Protocol

Hiermee geeft u het protocol dat is toegestaan voor een aanvraag. De aanvaardbare waarden voor deze parameter zijn:

  • HttpsOnly
  • HttpsOrHttp De standaardwaarde is HttpsOrHttp.
Type:Nullable<T>[SharedAccessProtocol]
Geaccepteerde waarden:HttpsOnly, HttpsOrHttp
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StartTime

Hiermee geeft u het tijdstip op waarop de handtekening voor gedeelde toegang geldig wordt.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

CloudBlob

IStorageContext

Uitvoerwaarden

String