Sdílet prostřednictvím


Set-AzStorageBlobLegalHold

Povolí nebo zakáže blokování z právních důvodů v objektu blob úložiště.

Syntax

Set-AzStorageBlobLegalHold
   [-Blob] <String>
   [-Container] <String>
   [-EnableLegalHold]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzStorageBlobLegalHold
   -BlobBaseClient <BlobBaseClient>
   [-EnableLegalHold]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzStorageBlobLegalHold
   -BlobBaseClient <BlobBaseClient>
   [-DisableLegalHold]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzStorageBlobLegalHold
   [-Blob] <String>
   [-Container] <String>
   [-DisableLegalHold]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina Set-AzStorageBlobLegalHold povolí nebo zakáže blokování z právních důvodů v objektu blob služby Storage. Rutina funguje jenom v případech, kdy už kontejner objektů blob povolil neměnné úložiště s verzí.

Příklady

Příklad 1: Povolení blokování z právních důvodů v objektu blob úložiště

$blob = Set-AzStorageBlobLegalHold -Container $containerName -Blob $blobname  -EnableLegalHold

$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.HasLegalHold
True

Tento příkaz povolí blokování objektu blob úložiště z právních důvodů a pak zobrazí výsledek. Příkaz funguje jenom v případech, kdy kontejner objektů blob už povolil neměnné úložiště s verzí.

Příklad 2: Zakažte blokování z právních důvodů u objektu blob úložiště s kanálem.

$blob = Get-AzStorageBlob -Container $containerName -Blob $blobname | Set-AzStorageBlobLegalHold -DisableLegalHold

$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.HasLegalHold
False

Tento příkaz zakáže blokování z právních důvodů u objektu blob úložiště s kanálem a pak zobrazí výsledek. Příkaz funguje jenom v případech, kdy kontejner objektů blob už povolil neměnné úložiště s verzí.

Parametry

-Blob

Název objektu blob

Typ:String
Position:0
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-BlobBaseClient

Objekt BlobBaseClient

Typ:BlobBaseClient
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-ClientTimeoutPerRequest

Maximální doba provádění na straně klienta pro každý požadavek v sekundách.

Typ:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Celkový počet souběžných asynchronních úloh. Výchozí hodnota je 10.

Typ:Nullable<T>[Int32]
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliases:cf
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

Název kontejneru

Typ:String
Position:1
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-Context

Kontextový objekt služby Azure Storage

Typ:IStorageContext
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableLegalHold

Zakažte LegalHold v objektu blob.

Typ:SwitchParameter
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-EnableLegalHold

Povolení LegalHoldu v objektu blob

Typ:SwitchParameter
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Časový limit serveru pro každý požadavek v sekundách vypršel.

Typ:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-TagCondition

Volitelný příkaz výrazu Tag pro kontrolu podmínky shody. Požadavek na objekt blob selže, pokud značky objektů blob neodpovídají danému výrazu. Podrobnosti najdete v https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operationstématu .

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliases:wi
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

BlobBaseClient

IStorageContext

Výstupy

AzureStorageBlob