Aracılığıyla paylaş

New-AzStorageBlobSASToken

  • Başvuru
Modül:
Az.Storage

Azure depolama blobu için sas belirteci oluşturur.

Sözdizimi

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

New-AzStorageBlobSASToken cmdlet'i bir Azure depolama blobu için Paylaşılan Erişim İmzası (SAS) belirteci oluşturur.

Örnekler

Örnek 1: Tam blob izniyle blob SAS belirteci oluşturma

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

Bu örnek, tam blob iznine sahip bir blob SAS belirteci oluşturur.

Örnek 2: Yaşam süresiyle blob SAS belirteci oluşturma

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

Bu örnek yaşam süresine sahip bir blob SAS belirteci oluşturur.

Örnek 3: OAuth kimlik doğrulamasını temel alan depolama bağlamı ile Kullanıcı Kimliği SAS belirteci oluşturma

$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

Bu örnek, OAuth kimlik doğrulamasını temel alan depolama bağlamı ile bir Kullanıcı Kimliği blob SAS belirteci oluşturur

Parametreler

-Blob

Depolama blobu adını belirtir.

Tür:String
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-BlobBaseClient

BlobBaseClient Nesnesi

Tür:BlobBaseClient
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-CloudBlob

CloudBlob nesnesini belirtir. CloudBlob nesnesi almak için Get-AzStorageBlob cmdlet'ini kullanın.

Tür:CloudBlob
Diğer adlar:ICloudBlob
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Container

Depolama kapsayıcısının adını belirtir.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Context

Depolama bağlamını belirtir. Depolama bağlamı OAuth kimlik doğrulamasını temel alırsa bir Kullanıcı Kimliği blob SAS belirteci oluşturur.

Tür:IStorageContext
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-EncryptionScope

Bu SAS URI'si ile yetkilendirilmiş istekleri gönderirken kullanılacak şifreleme kapsamı.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ExpiryTime

Paylaşılan erişim imzasının süresinin ne zaman doleceğini belirtir. Depolama bağlamı OAuth kimlik doğrulamasına dayalı olduğunda, süresi dolma süresi geçerli saatten itibaren 7 gün içinde olmalı ve geçerli saatten daha erken olmamalıdır.

Tür:Nullable<T>[DateTime]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-FullUri

Bu cmdlet'in tam blob URI'sini ve paylaşılan erişim imzası belirtecini döndürdüğünü gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IPAddressOrRange

168.1.5.65 veya 168.1.5.60-168.1.5.70 gibi isteklerin kabul edildiği IP adresini veya IP adresi aralığını belirtir. Aralık kapsayıcıdır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Permission

Depolama blobu için izinleri belirtir. Bunun (Okuma, Yazma ve Silme için) gibi rwd bir dize olduğuna dikkat etmek önemlidir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Policy

Azure Saklı Erişim İlkesi belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Protocol

İstek için izin verilen protokolü belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • HttpsOnly
  • HttpsOrHttp Varsayılan değer HttpsOrHttp'dır.
Tür:Nullable<T>[SharedAccessProtocol]
Kabul edilen değerler:HttpsOnly, HttpsOrHttp
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-StartTime

Paylaşılan erişim imzasının geçerli olduğu zamanı belirtir.

Tür:Nullable<T>[DateTime]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

CloudBlob

IStorageContext

Çıkışlar

String