Set-AzStorageBlobImmutabilityPolicy
Tworzy lub aktualizuje niezmiennośćZasady obiektu blob usługi Storage.
Składnia
Set-AzStorageBlobImmutabilityPolicy
[-Blob] <String>
[-Container] <String>
-ExpiresOn <DateTimeOffset>
[-PolicyMode <String>]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzStorageBlobImmutabilityPolicy
-BlobBaseClient <BlobBaseClient>
-ExpiresOn <DateTimeOffset>
[-PolicyMode <String>]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Set-AzStorageBlobImmutabilityPolicy tworzy lub aktualizuje element ImmutabilityPolicy obiektu blob usługi Storage. Polecenie cmdlet działa tylko wtedy, gdy kontener obiektów blob włączył już niezmienny magazyn z przechowywaniem wersji.
Przykłady
Przykład 1. Tworzenie lub aktualizowanie zasad niezmienności obiektu blob usługi Storage.
$blob = Set-AzStorageBlobImmutabilityPolicy -Container $containerName -Blob $blobname -ExpiresOn (Get-Date).AddDays(100) -PolicyMode Unlocked
$blob
AccountName: mystorageaccount, ContainerName: mycontainer
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
testblob BlockBlob 10485760 application/octet-stream 2021-07-19 08:56:00Z Hot False 2021-07-19T08:56:01.8120788Z *
$blob.BlobProperties.ImmutabilityPolicy
ExpiresOn PolicyMode
--------- ----------
10/27/2021 8:56:32 AM +00:00 Unlocked
To polecenie tworzy lub aktualizuje element ImmutabilityPolicy obiektu blob usługi Storage, a następnie wyświetla obiekt blob i jego niezmiennośćPolicy. Polecenie działa tylko wtedy, gdy kontener obiektów blob włączył już niezmienny magazyn z przechowywaniem wersji.
Parametry
-Blob
Nazwa obiektu blob
Typ: | String |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-BlobBaseClient
Obiekt BlobBaseClient
Typ: | BlobBaseClient |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-ClientTimeoutPerRequest
Maksymalny czas wykonywania po stronie klienta dla każdego żądania w sekundach.
Typ: | Nullable<T>[Int32] |
Aliasy: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ConcurrentTaskCount
Całkowita ilość współbieżnych zadań asynchronicznych. 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ść: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Container
Nazwa kontenera
Typ: | String |
Position: | 1 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Context
Obiekt kontekstu usługi Azure Storage
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 |
-ExpiresOn
ImmutabilityPolicy Obiektu blob Wygasa
Typ: | Nullable<T>[DateTimeOffset] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PolicyMode
Blob ImmutabilityPolicy PolicyMode
Typ: | String |
Dopuszczalne wartości: | Unlocked, Locked, Mutable |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ServerTimeoutPerRequest
Limit czasu serwera dla każdego żądania w sekundach.
Typ: | Nullable<T>[Int32] |
Aliasy: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | String |
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ść: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |