Delen via


New-AzStorageBlobSASToken

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

Syntaxis

BlobNameWithPermission (Standaard)

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

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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobNameWithPermission
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
BlobNameWithPolicy
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-BlobBaseClient

BlobBaseClient-object

Parametereigenschappen

Type:BlobBaseClient
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobPipelineWithPolicy
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False
BlobPipelineWithPermission
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-CloudBlob

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

Parametereigenschappen

Type:Microsoft.Azure.Storage.Blob.CloudBlob
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ICloudBlob

Parametersets

BlobPipelineWithPolicy
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False
BlobPipelineWithPermission
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Container

Hiermee geeft u de naam van de opslagcontainer op.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobNameWithPermission
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
BlobNameWithPolicy
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:IStorageContext
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-EncryptionScope

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[DateTime]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-FullUri

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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).

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobNameWithPermission
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
BlobPipelineWithPermission
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Policy

Hiermee geeft u een opgeslagen toegangsbeleid voor Azure op.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobPipelineWithPolicy
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
BlobNameWithPolicy
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Protocol

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

  • HttpsOnly
  • HttpsOrHttp De standaardwaarde is HttpsOrHttp.

Parametereigenschappen

Type:

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

Default value:None
Geaccepteerde waarden:HttpsOnly, HttpsOrHttp
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-StartTime

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

Parametereigenschappen

Type:

Nullable<T>[DateTime]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

Uitvoerwaarden

String