Udostępnij przez

Remove-AzStorageBlob

Moduł:
Az.Storage Module

Usuwa określony obiekt blob magazynu.

Składnia

NamePipeline (Domyślne) 

Remove-AzStorageBlob
    [-Blob] <String>
    [-Container] <String>
    [-DeleteSnapshot]
    [-SnapshotTime <DateTimeOffset>]
    [-VersionId <String>]
    [-Force]
    [-PassThru]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobPipeline 

Remove-AzStorageBlob
    -CloudBlob <CloudBlob>
    [-BlobBaseClient <BlobBaseClient>]
    [-DeleteSnapshot]
    [-Force]
    [-PassThru]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ContainerPipeline 

Remove-AzStorageBlob
    [-Blob] <String>
    -CloudBlobContainer <CloudBlobContainer>
    [-DeleteSnapshot]
    [-SnapshotTime <DateTimeOffset>]
    [-VersionId <String>]
    [-Force]
    [-PassThru]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet Remove-AzStorageBlob usuwa określony obiekt blob z konta magazynu na platformie Azure.

Przykłady

Przykład 1. Usuwanie obiektu blob magazynu według nazwy

Remove-AzStorageBlob -Container "ContainerName" -Blob "BlobName"

To polecenie usuwa obiekt blob identyfikowany przez jego nazwę.

Przykład 2. Usuwanie obiektu blob magazynu przy użyciu potoku

Get-AzStorageBlob -Container "ContainerName" -Blob "BlobName" | Remove-AzStorageBlob

To polecenie używa potoku.

Przykład 3. Usuwanie obiektów blob magazynu przy użyciu potoku

Get-AzStorageContainer -Container container* | Remove-AzStorageBlob -Blob "BlobName"

To polecenie używa gwiazdki (*) symbolu wieloznakowego i potoku, aby pobrać obiekt blob lub obiekty blob, a następnie je usunąć.

Przykład 4. Usuwanie pojedynczej wersji obiektu blob

Remove-AzStorageBlob -Container "containername" -Blob blob2 -VersionId "2020-07-03T16:19:16.2883167Z"

To polecenie usuwa jedną wersję obiektów blob z identyfikatorem VersionId.

Przykład 5. Usuwanie pojedynczej migawki obiektu blob

Remove-AzStorageBlob -Container "containername" -Blob blob1 -SnapshotTime "2020-07-06T06:56:06.8588431Z"

To polecenie usuwa pojedynczą migawkę obiektów blob z migawką SnapshotTime.

Parametry

-Blob

Określa nazwę obiektu blob, który chcesz usunąć.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

NamePipeline
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
ContainerPipeline
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-BlobBaseClient

Obiekt BlobBaseClient

Właściwości parametrów

Typ:BlobBaseClient
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

BlobPipeline
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:

Nullable<T>[Int32]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:ClientTimeoutPerRequestInSeconds

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-CloudBlob

Określa obiekt blob w chmurze. Aby uzyskać obiekt CloudBlob , użyj polecenia cmdlet Get-AzStorageBlob.

Właściwości parametrów

Typ:Microsoft.Azure.Storage.Blob.CloudBlob
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:ICloudBlob

Zbiory parametrów

BlobPipeline
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-CloudBlobContainer

Określa obiekt CloudBlobContainer z biblioteki klienta usługi Azure Storage. Aby go pobrać, możesz użyć polecenia cmdlet Get-AzStorageContainer.

Właściwości parametrów

Typ:Microsoft.Azure.Storage.Blob.CloudBlobContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ContainerPipeline
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:

Nullable<T>[Int32]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Container

Określa nazwę kontenera.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

NamePipeline
Pozycja:1
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Context

Określa kontekst usługi Azure Storage. Aby go utworzyć, możesz użyć polecenia cmdlet New-AzStorageContext.

Właściwości parametrów

Typ:IStorageContext
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DeleteSnapshot

Określa, że wszystkie migawki mają zostać usunięte, ale nie podstawowy obiekt blob. Jeśli ten parametr nie zostanie określony, podstawowy obiekt blob i jego migawki zostaną usunięte razem. Użytkownik jest monitowany o potwierdzenie operacji usuwania.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Force

Wskazuje, że to polecenie cmdlet usuwa obiekt blob i jego migawkę bez potwierdzenia.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-PassThru

Wskazuje, że to polecenie cmdlet zwraca wartość logiczną , która odzwierciedla powodzenie operacji. Domyślnie to polecenie cmdlet nie zwraca wartości.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ServerTimeoutPerRequest

Określa profil platformy Azure dla polecenia cmdlet do odczytania. Jeśli nie zostanie określony, polecenie cmdlet odczytuje z profilu domyślnego.

Właściwości parametrów

Typ:

Nullable<T>[Int32]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:ServerTimeoutPerRequestInSeconds

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-SnapshotTime

Czas migawki obiektu blob

Właściwości parametrów

Typ:

Nullable<T>[DateTimeOffset]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

NamePipeline
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
ContainerPipeline
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-VersionId

Identyfikator wersji obiektu blob

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

NamePipeline
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
ContainerPipeline
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

Microsoft.Azure.Storage.Blob.CloudBlob

Microsoft.Azure.Storage.Blob.CloudBlobContainer

IStorageContext

Wyjść

Boolean