Condividi tramite


New-AzStorageBlobSASToken

Genera un token di firma di accesso condiviso per un BLOB di archiviazione di Azure.

Sintassi

BlobNameWithPermission (Impostazione predefinita)

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

Descrizione

Il cmdlet New-AzStorageBlobSASToken genera un token di firma di accesso condiviso per un BLOB di archiviazione di Azure.

Esempio

Esempio 1: Generare un token di firma di accesso condiviso BLOB con autorizzazione BLOB completa

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

Questo esempio genera un token di firma di accesso condiviso BLOB con autorizzazione BLOB completa.

Esempio 2: Generare un token di firma di accesso condiviso BLOB con durata

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

Questo esempio genera un token di firma di accesso condiviso BLOB con durata.

Esempio 3: Generare un token di firma di accesso condiviso dell'identità utente con contesto di archiviazione basato sull'autenticazione 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

Questo esempio genera un token di firma di accesso condiviso del BLOB di identità utente con contesto di archiviazione basato sull'autenticazione OAuth

Parametri

-Blob

Specifica il nome del BLOB di archiviazione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

BlobNameWithPermission
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
BlobNameWithPolicy
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-BlobBaseClient

Oggetto BlobBaseClient

Proprietà dei parametri

Tipo:BlobBaseClient
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

BlobPipelineWithPolicy
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False
BlobPipelineWithPermission
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-CloudBlob

Specifica l'oggetto CloudBlob . Per ottenere un oggetto CloudBlob , usare il cmdlet Get-AzStorageBlob .

Proprietà dei parametri

Tipo:Microsoft.Azure.Storage.Blob.CloudBlob
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ICloudBlob

Set di parametri

BlobPipelineWithPolicy
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False
BlobPipelineWithPermission
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Container

Specifica il nome del contenitore di archiviazione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

BlobNameWithPermission
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
BlobNameWithPolicy
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Context

Specifica il contesto di archiviazione. Quando il contesto di archiviazione è basato sull'autenticazione OAuth, genera un token di firma di accesso condiviso del BLOB di identità utente.

Proprietà dei parametri

Tipo:IStorageContext
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-EncryptionScope

Ambito di crittografia da usare quando si inviano richieste autorizzate con questo URI di firma di accesso condiviso.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ExpiryTime

Specifica quando scade la firma di accesso condiviso. Quando il contesto di archiviazione si basa sull'autenticazione OAuth, la scadenza deve essere entro 7 giorni dall'ora corrente e non deve essere precedente all'ora corrente.

Proprietà dei parametri

Tipo:

Nullable<T>[DateTime]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FullUri

Indica che questo cmdlet restituisce l'URI BLOB completo e il token di firma di accesso condiviso.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IPAddressOrRange

Specifica l'indirizzo IP o l'intervallo di indirizzi IP da cui accettare richieste, ad esempio 168.1.5.65 o 168.1.5.60-168.1.5.70. L'intervallo è inclusivo.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Permission

Specifica le autorizzazioni per un BLOB di archiviazione. È importante notare che si tratta di una stringa, ad esempio rwd (per Lettura, Scrittura ed Eliminazione).

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

BlobNameWithPermission
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
BlobPipelineWithPermission
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Policy

Specifica un criterio di accesso archiviato di Azure.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

BlobPipelineWithPolicy
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
BlobNameWithPolicy
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Protocol

Specifica il protocollo consentito per una richiesta. I valori accettabili per questo parametro sono:

  • HttpsOnly
  • HttpsOrHttp Il valore predefinito è HttpsOrHttp.

Proprietà dei parametri

Tipo:

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

Valore predefinito:None
Valori accettati:HttpsOnly, HttpsOrHttp
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-StartTime

Specifica l'ora in cui la firma di accesso condiviso diventa valida.

Proprietà dei parametri

Tipo:

Nullable<T>[DateTime]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

Output

String