Udostępnij za pomocą

Set-AzStorageBlobContent

Moduł:
Az.Storage Module

Przekazuje plik lokalny do obiektu blob usługi Azure Storage.

Składnia

SendManual (domyślnie) 

Set-AzStorageBlobContent
    [-File] <String>
    [-Container] <String>
    [-Blob <String>]
    [-BlobType <String>]
    [-Properties <Hashtable>]
    [-Metadata <Hashtable>]
    [-Tag <Hashtable>]
    [-PremiumPageBlobTier <PremiumPageBlobTier>]
    [-StandardBlobTier <String>]
    [-EncryptionScope <String>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ContainerPipeline 

Set-AzStorageBlobContent
    [-File] <String>
    -CloudBlobContainer <CloudBlobContainer>
    [-Blob <String>]
    [-BlobType <String>]
    [-Properties <Hashtable>]
    [-Metadata <Hashtable>]
    [-Tag <Hashtable>]
    [-PremiumPageBlobTier <PremiumPageBlobTier>]
    [-StandardBlobTier <String>]
    [-EncryptionScope <String>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobPipeline 

Set-AzStorageBlobContent
    [-File] <String>
    -CloudBlob <CloudBlob>
    [-BlobType <String>]
    [-Properties <Hashtable>]
    [-Metadata <Hashtable>]
    [-Tag <Hashtable>]
    [-PremiumPageBlobTier <PremiumPageBlobTier>]
    [-StandardBlobTier <String>]
    [-EncryptionScope <String>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzStorageBlobContent przekazuje plik lokalny do obiektu blob usługi Azure Storage.

Przykłady

Przykład 1. Przekazywanie nazwanego pliku

Set-AzStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"

To polecenie przekazuje plik o nazwie PlanningData do obiektu blob o nazwie Planning2015.

Przykład 2. Przekazywanie wszystkich plików w bieżącym folderze

Get-ChildItem -File -Recurse | Set-AzStorageBlobContent -Container "ContosoUploads"

To polecenie używa podstawowego polecenia cmdlet programu Windows PowerShell Get-ChildItem, aby pobrać wszystkie pliki w bieżącym folderze i w podfolderach, a następnie przekazuje je do bieżącego polecenia cmdlet przy użyciu operatora potoku. Polecenie cmdlet Set-AzStorageBlobContent przekazuje pliki do kontenera o nazwie ContosoUploads.

Przykład 3. Zastępowanie istniejącego obiektu blob

Get-AzStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzStorageBlobContent -File "ContosoPlanning"

To polecenie pobiera obiekt blob o nazwie Planning2015 w kontenerze ContosoUploads przy użyciu polecenia cmdlet Get-AzStorageBlob, a następnie przekazuje ten obiekt blob do bieżącego polecenia cmdlet. Polecenie przekazuje plik o nazwie ContosoPlanning jako Planning2015. To polecenie nie określa parametru Force . Polecenie wyświetla monit o potwierdzenie. Jeśli potwierdzisz to polecenie, polecenie cmdlet zastępuje istniejący obiekt blob.

Przykład 4. Przekazywanie pliku do kontenera przy użyciu potoku

Get-AzStorageContainer -Container "ContosoUpload*" | Set-AzStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

To polecenie pobiera kontener rozpoczynający się od ciągu ContosoUpload przy użyciu polecenia cmdlet Get-AzStorageContainer , a następnie przekazuje ten obiekt blob do bieżącego polecenia cmdlet. Polecenie przekazuje plik o nazwie ContosoPlanning jako Planning2015.

Przykład 5. Przekazywanie pliku do stronicowego obiektu blob przy użyciu metadanych i klasy PremiumPageBlobTier jako P10

$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10

Pierwsze polecenie tworzy tabelę skrótów zawierającą metadane obiektu blob i przechowuje tabelę skrótów w zmiennej $Metadata. Drugie polecenie przekazuje plik o nazwie ContosoPlanning do kontenera o nazwie ContosoUploads. Obiekt blob zawiera metadane przechowywane w $Metadata i ma wartość PremiumPageBlobTier jako P10.

Przykład 6. Przekazywanie pliku do obiektu blob z określonymi właściwościami obiektu blob i ustawianie wartości StandardBlobTier jako Chłodna

$filepath = "c:\temp\index.html"
Set-AzStorageBlobContent -File $filepath -Container "contosouploads" -Properties @{"ContentType" = [System.Web.MimeMapping]::GetMimeMapping($filepath); "ContentMD5" = "i727sP7HigloQDsqadNLHw=="} -StandardBlobTier Cool

AccountName: storageaccountname, ContainerName: contosouploads

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------
index.html           BlockBlob 403116          text/html                      2020-09-22 08:06:53Z Cool                                    False

To polecenie przekazuje plik c:\temp\index.html do kontenera o nazwie contosouploads z określonymi właściwościami obiektu blob i ustaw standardBlobTier jako Cool. To polecenie pobiera wartość ContentType ustawioną na właściwości obiektu blob przez interfejs API [System.Web.MimeMapping]::GetMimeMapping().

Przykład 7. Przekazywanie pliku do obiektu blob przy użyciu zakresu szyfrowania

$blob = Set-AzStorageBlobContent  -File "mylocalfile" -Container "mycontainer" -Blob "myblob"  -EncryptionScope "myencryptscope"

$blob.BlobProperties.EncryptionScope

myencryptscope

To polecenie przekazuje plik do obiektu blob z zakresem szyfrowania.

Parametry

-AsJob

Uruchom polecenie cmdlet w tle.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Blob

Określa nazwę obiektu blob. To polecenie cmdlet przekazuje plik do obiektu blob usługi Azure Storage, który określa ten parametr.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SendManual
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
ContainerPipeline
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-BlobType

Określa typ obiektu blob, który przekazuje to polecenie cmdlet. Dopuszczalne wartości tego parametru to:

  • Blok
  • Strona
  • Append

Wartość domyślna to Blokuj.

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:Block, Page, Append
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ClientTimeoutPerRequest

Określa interwał limitu czasu po stronie klienta w sekundach dla jednego żądania obsługi. Jeśli poprzednie wywołanie zakończy się niepowodzeniem w określonym interwale, to polecenie cmdlet ponawia próbę żądania. Jeśli to polecenie cmdlet nie otrzyma pomyślnej odpowiedzi przed upływem interwału, to polecenie cmdlet zwróci błąd.

Właściwości parametru

Typ:

Nullable<T>[Int32]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:ClientTimeoutPerRequestInSeconds

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-CloudBlob

Określa obiekt CloudBlob . Aby uzyskać obiekt CloudBlob , użyj polecenia cmdlet Get-AzStorageBlob.

Właściwości parametru

Typ:Microsoft.Azure.Storage.Blob.CloudBlob
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:ICloudBlob

Zestawy parametrów

BlobPipeline
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-CloudBlobContainer

Określa obiekt CloudBlobContainer z biblioteki klienta usługi Azure Storage. To polecenie cmdlet przekazuje zawartość do obiektu blob w kontenerze, który określa ten parametr. Aby uzyskać obiekt CloudBlobContainer , użyj polecenia cmdlet Get-AzStorageContainer.

Właściwości parametru

Typ:Microsoft.Azure.Storage.Blob.CloudBlobContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ContainerPipeline
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ConcurrentTaskCount

Określa maksymalne współbieżne wywołania sieciowe. Tego parametru można użyć, aby ograniczyć współbieżność w celu ograniczenia użycia lokalnego procesora CPU i przepustowości, określając maksymalną liczbę współbieżnych wywołań sieciowych. Określona wartość jest liczbą bezwzględną i nie jest mnożona przez liczbę rdzeni. Ten parametr może pomóc w zmniejszeniu problemów z połączeniem sieciowym w środowiskach o niskiej przepustowości, takich jak 100 kilobitów na sekundę. Wartość domyślna to 10.

Właściwości parametru

Typ:

Nullable<T>[Int32]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Container

Określa nazwę kontenera. To polecenie cmdlet przekazuje plik do obiektu blob w kontenerze, który określa ten parametr.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SendManual
Position:1
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Context

Określa kontekst usługi Azure Storage. Aby uzyskać kontekst magazynu, użyj polecenia cmdlet New-AzStorageContext. Aby użyć kontekstu magazynu utworzonego na podstawie tokenu SAS bez uprawnień do odczytu, należy dodać parametr -Force, aby pominąć sprawdzanie istnienia obiektu blob.

Właściwości parametru

Typ:IStorageContext
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-EncryptionScope

Zakres szyfrowania do użycia podczas wprowadzania żądań do obiektu blob.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-File

Określa lokalną ścieżkę pliku do przekazania jako zawartość obiektu blob.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:FullName

Zestawy parametrów

SendManual
Position:0
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Force

Wskazuje, że to polecenie cmdlet zastępuje istniejący obiekt blob bez monitowania o potwierdzenie.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Metadata

Określa metadane przekazanego obiektu blob.

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PremiumPageBlobTier

Warstwa stronicowego obiektu blob

Właściwości parametru

Typ:Microsoft.Azure.Storage.Blob.PremiumPageBlobTier
Domyślna wartość:None
Dopuszczalne wartości:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Properties

Określa właściwości przekazanego obiektu blob. Obsługiwane właściwości to: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ServerTimeoutPerRequest

Określa interwał limitu czasu po stronie usługi w sekundach dla żądania. Jeśli określony interwał upłynie, zanim usługa przetworzy żądanie, usługa magazynu zwróci błąd.

Właściwości parametru

Typ:

Nullable<T>[Int32]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:ServerTimeoutPerRequestInSeconds

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-StandardBlobTier

Warstwa blokowych obiektów blob, prawidłowe wartości to Gorąca/Chłodna/Archiwum/Zimno. Zobacz szczegóły w https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Tag

Tagi obiektów blob

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-TagCondition

Opcjonalna instrukcja wyrażenia tagu w celu sprawdzenia warunku dopasowania. Żądanie obiektu blob zakończy się niepowodzeniem, gdy tagi obiektów blob nie są zgodne z danym wyrażeniem. Zobacz szczegóły w pliku https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

Microsoft.Azure.Storage.Blob.CloudBlobContainer

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

Dane wyjściowe

AzureStorageBlob