Aracılığıyla paylaş


New-AzStorageBlobSASToken

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

Syntax

BlobNameWithPermission (Varsayılan)

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>]

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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

BlobNameWithPermission
Position:1
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False
BlobNameWithPolicy
Position:1
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-BlobBaseClient

BlobBaseClient Nesnesi

Parametre özellikleri

Tür:BlobBaseClient
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

BlobPipelineWithPolicy
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False
BlobPipelineWithPermission
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-CloudBlob

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

Parametre özellikleri

Tür:Microsoft.Azure.Storage.Blob.CloudBlob
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:ICloudBlob

Parametre kümeleri

BlobPipelineWithPolicy
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False
BlobPipelineWithPermission
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Confirm

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Container

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

BlobNameWithPermission
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False
BlobNameWithPolicy
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:IStorageContext
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-DefaultProfile

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

Parametre özellikleri

Tür:IAzureContextContainer
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:AzureRmContext, AzureCredential

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-EncryptionScope

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:

Nullable<T>[DateTime]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-FullUri

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Permission

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

BlobNameWithPermission
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False
BlobPipelineWithPermission
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Policy

Azure Saklı Erişim İlkesi belirtir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

BlobPipelineWithPolicy
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False
BlobNameWithPolicy
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Protocol

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

  • HttpsOnly
  • HttpsOrHttp Varsayılan değer HttpsOrHttp'dır.

Parametre özellikleri

Tür:

Nullable<T>[Microsoft.Azure.Storage.SharedAccessProtocol]

Default value:None
Kabul edilen değerler:HttpsOnly, HttpsOrHttp
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-StartTime

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

Parametre özellikleri

Tür:

Nullable<T>[DateTime]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

Çıkışlar

String