Set-AzureStorageBlobContent
Przekazuje plik lokalny do obiektu blob usługi Azure Storage.
Ostrzeżenie
Moduł AzureRM PowerShell jest 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 P10Pierwsze 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Dopuszczalne wartości: | Block, Page, Append |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | Nullable<T>[Int32] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-CloudBlob
Określa obiekt CloudBlob . Aby uzyskać obiekt CloudBlob , użyj polecenia cmdlet Get-AzureStorageBlob.
| Typ: | CloudBlob |
| Aliasy: | ICloudBlob |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | CloudBlobContainer |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | Nullable<T>[Int32] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Container
Określa nazwę kontenera. To polecenie cmdlet przekazuje plik do obiektu blob w kontenerze, który określa ten parametr.
| Typ: | String |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | IStorageContext |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
| Typ: | IAzureContextContainer |
| Aliasy: | AzureRmContext, AzureCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-File
Określa lokalną ścieżkę pliku do przekazania jako zawartość obiektu blob.
| Typ: | String |
| Aliasy: | FullName |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Force
Wskazuje, że to polecenie cmdlet zastępuje istniejący obiekt blob bez monitowania o potwierdzenie.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Metadata
Określa metadane przekazanego obiektu blob.
| Typ: | Hashtable |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PremiumPageBlobTier
Warstwa stronicowego obiektu blob
| Typ: | PremiumPageBlobTier |
| Dopuszczalne wartości: | Unknown, P4, P6, P10, P20, P30, P40, P50, P60 |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Properties
Określa właściwości przekazanego obiektu blob. Obsługiwane właściwości to: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.
| Typ: | Hashtable |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | Nullable<T>[Int32] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |