Share via

Set-AzureStorageBlobContent

  • Odwołanie
Moduł:
Azure.Storage

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

Ostrzeżenie

Moduł AzureRM PowerShell został oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

Set-AzureStorageBlobContent
   [-File] <String>
   [-Container] <String>
   [-Blob <String>]
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   [-Blob <String>]
   -CloudBlobContainer <CloudBlobContainer>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   -CloudBlob <CloudBlob>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

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

Przykłady

Przykład 1. Przekazywanie nazwanego pliku

PS C:\>Set-AzureStorageBlobContent -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

PS C:\>Get-ChildItem -File -Recurse | Set-AzureStorageBlobContent -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-AzureStorageBlobContent przekazuje pliki do kontenera o nazwie ContosoUploads.

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

PS C:\>Get-AzureStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzureStorageBlobContent -File "ContosoPlanning"

To polecenie pobiera obiekt blob o nazwie Planning2015 w kontenerze ContosoUploads przy użyciu polecenia cmdlet Get-AzureStorageBlob, 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

PS C:\>Get-AzureStorageContainer -Container "ContosoUpload*" | Set-AzureStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

To polecenie pobiera kontener rozpoczynający się od ciągu ContosoUpload przy użyciu polecenia cmdlet Get-AzureStorageContainer , 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

PS C:\>$Metadata = @{"key" = "value"; "name" = "test"}
PS C:\> Set-AzureStorageBlobContent -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

PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Properties @{"ContentType" = "image/jpeg"; "ContentMD5" = "i727sP7HigloQDsqadNLHw=="}

To polecenie przekazuje plik o nazwie ContosoPlanning do kontenera o nazwie ContosoUploads z określonymi właściwościami obiektu blob.

Parametry

-Blob

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BlobType

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

  • Zablokowanie
  • Page Wartość domyślna to Blokuj.
Type:String
Accepted values:Block, Page, Append
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CloudBlob

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

Type:CloudBlob
Aliases:ICloudBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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-AzureStorageContainer.

Type:CloudBlobContainer
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Context

Określa kontekst usługi Azure Storage. Aby uzyskać kontekst magazynu, użyj polecenia cmdlet New-AzureStorageContext. 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.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-File

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

Type:String
Aliases:FullName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Metadata

Określa metadane przekazanego obiektu blob.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PremiumPageBlobTier

Warstwa stronicowego obiektu blob

Type:PremiumPageBlobTier
Accepted values:Unknown, P4, P6, P10, P20, P30, P40, P50, P60
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Properties

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

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

String

CloudBlobContainer

CloudBlob

IStorageContext

Dane wyjściowe

AzureStorageBlob