Set-AzStorageBlobLegalHold
Active ou désactive la conservation légale sur un objet blob de stockage.
Syntaxe
NamePipelineEnable (Par défaut)
Set-AzStorageBlobLegalHold
[-Blob] <String>
[-Container] <String>
[-EnableLegalHold]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
BlobPipelineEnable
Set-AzStorageBlobLegalHold
-BlobBaseClient <BlobBaseClient>
[-EnableLegalHold]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
BlobPipelineDisable
Set-AzStorageBlobLegalHold
-BlobBaseClient <BlobBaseClient>
[-DisableLegalHold]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NamePipelineDisable
Set-AzStorageBlobLegalHold
[-Blob] <String>
[-Container] <String>
[-DisableLegalHold]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Set-AzStorageBlobLegalHold active ou désactive la conservation légale sur un objet blob de stockage.
L’applet de commande fonctionne uniquement lorsque le conteneur d’objets blob a déjà activé le stockage immuable avec contrôle de version.
Exemples
Exemple 1 : Activer la conservation légale sur un objet blob de stockage.
$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
Cette commande active la conservation légale sur un objet blob de stockage, puis affiche le résultat.
La commande fonctionne uniquement lorsque le conteneur d’objets blob a déjà activé le stockage immuable avec contrôle de version.
Exemple 2 : Désactiver la conservation légale sur un objet blob de stockage avec pipeline.
$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
Cette commande désactive la conservation légale sur un objet blob de stockage avec pipeline, puis affiche le résultat.
La commande fonctionne uniquement lorsque le conteneur d’objets blob a déjà activé le stockage immuable avec contrôle de version.
Paramètres
-Blob
Nom de l’objet blob
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
NamePipelineEnable
Position: 0 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
NamePipelineDisable
Position: 0 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-BlobBaseClient
Objet BlobBaseClient
Propriétés du paramètre
Type: BlobBaseClient
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
BlobPipelineEnable
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
BlobPipelineDisable
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-ClientTimeoutPerRequest
Durée d’exécution maximale côté client pour chaque requête en secondes.
Propriétés du paramètre
Type: Nullable<T> [ Int32 ]
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: ClientTimeoutPerRequestInSeconds
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ConcurrentTaskCount
Quantité totale de tâches asynchrones simultanées.
La valeur par défaut est 10.
Propriétés du paramètre
Type: Nullable<T> [ Int32 ]
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: cf
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Container
Nom du conteneur
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
NamePipelineEnable
Position: 1 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
NamePipelineDisable
Position: 1 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Context
Objet de contexte stockage Azure
Propriétés du paramètre
Type: IStorageContext
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: True Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Propriétés du paramètre
Type: IAzureContextContainer
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: AzureRmContext, AzureCredential
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DisableLegalHold
Désactivez LegalHold sur l’objet blob.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
BlobPipelineDisable
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
NamePipelineDisable
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-EnableLegalHold
Activez LegalHold sur l’objet blob.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
NamePipelineEnable
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
BlobPipelineEnable
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ServerTimeoutPerRequest
Délai d’expiration du serveur pour chaque requête en secondes.
Propriétés du paramètre
Type: Nullable<T> [ Int32 ]
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: ServerTimeoutPerRequestInSeconds
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-TagCondition
Instruction d’expression tag facultative pour vérifier la condition de correspondance. La demande d’objet blob échoue lorsque les balises d’objet blob ne correspondent pas à l’expression donnée. Voir les détails dans https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations .
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute.
L’applet de commande ne s’exécute pas.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: Wi
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters .
Sorties
