Remove-AzStorageFile
Löscht eine Datei.
Syntax
Remove-AzStorageFile
[-ShareName] <String>
[-Path] <String>
[-PassThru]
[-DisAllowTrailingDot]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzStorageFile
[-Share] <CloudFileShare>
[-ShareClient <ShareClient>]
[-Path] <String>
[-PassThru]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzStorageFile
[-Directory] <CloudFileDirectory>
[-ShareDirectoryClient <ShareDirectoryClient>]
[-Path] <String>
[-PassThru]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzStorageFile
[-File] <CloudFile>
[-ShareFileClient <ShareFileClient>]
[-PassThru]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Remove-AzStorageFile löscht eine Datei.
Beispiele
Beispiel 1: Löschen einer Datei aus einer Dateifreigabe
Remove-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoFile22"
Mit diesem Befehl wird die Datei namens ContosoFile22 aus der Dateifreigabe namens ContosoShare06 gelöscht.
Beispiel 2: Abrufen einer Datei aus einer Dateifreigabe mithilfe eines Dateifreigabeobjekts
Get-AzStorageShare -Name "ContosoShare06" | Remove-AzStorageFile -Path "ContosoFile22"
Dieser Befehl verwendet das Cmdlet "Get-AzStorageShare ", um die Dateifreigabe mit dem Namen ContosoShare06 abzurufen, und übergibt dieses Objekt dann mithilfe des Pipelineoperators an das aktuelle Cmdlet. Der aktuelle Befehl löscht die Datei namens ContosoFile22 aus ContosoShare06.
Parameter
-ClientTimeoutPerRequest
Gibt das clientseitige Timeoutintervall in Sekunden für eine Serviceanfrage an. Wenn der vorherige Aufruf im angegebenen Intervall fehlschlägt, führt dieses Cmdlet die Anforderung erneut aus. Wenn dieses Cmdlet vor Ablauf des Intervalls keine erfolgreiche Antwort erhält, gibt dieses Cmdlet einen Fehler zurück.
Typ: | Nullable<T>[Int32] |
Aliase: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ConcurrentTaskCount
Gibt die maximalen gleichzeitigen Netzwerkanrufe an. Mit diesem Parameter können Sie die Parallelität einschränken, um die lokale CPU- und Bandbreitenauslastung zu drosseln, indem Sie die maximale Anzahl gleichzeitiger Netzwerkanrufe angeben. Der angegebene Wert ist eine absolute Anzahl und wird nicht mit der Kernanzahl multipliziert. Dieser Parameter kann dazu beitragen, Netzwerkverbindungsprobleme in Umgebungen mit geringer Bandbreite zu reduzieren, z. B. 100 Kilobit pro Sekunde. Der Standardwert lautet 10.
Typ: | Nullable<T>[Int32] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Context
Gibt einen Azure-Speicherkontext an. Verwenden Sie zum Abrufen eines Speicherkontexts das Cmdlet New-AzStorageContext .
Typ: | IStorageContext |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Typ: | IAzureContextContainer |
Aliase: | AzureRmContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Directory
Gibt einen Ordner als CloudFileDirectory -Objekt an. Mit diesem Cmdlet wird eine Datei im Ordner entfernt, den dieser Parameter angibt.
Typ: | CloudFileDirectory |
Aliase: | CloudFileDirectory |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-DisAllowTrailingDot
Nicht zulassen, dass nachgestellter Punkt (.) verzeichnis- und Dateinamen suffixiert werden.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-File
Gibt eine Datei als CloudFile-Objekt an. Mit diesem Cmdlet wird die Datei entfernt, die dieser Parameter angibt. Verwenden Sie das Cmdlet Get-AzStorageFile, um ein CloudFile-Objekt abzurufen.
Typ: | CloudFile |
Aliase: | CloudFile |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-PassThru
Gibt an, dass dieses Cmdlet einen Wert vom Typ Boolean zurückgibt, der den Erfolg des Vorgangs widerspiegelt. Standardmäßig gibt dieses Cmdlet keinen Wert zurück.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Path
Gibt den Pfad einer Datei an. Dieses Cmdlet löscht die Datei, die dieser Parameter angibt.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ServerTimeoutPerRequest
Gibt die Länge des Timeoutzeitraums für den Serverteil einer Anforderung an.
Typ: | Nullable<T>[Int32] |
Aliase: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Share
Gibt ein CloudFileShare -Objekt an. Mit diesem Cmdlet wird die Datei in der Freigabe entfernt, die dieser Parameter angibt. Verwenden Sie das Cmdlet Get-AzStorageShare, um ein CloudFileShare-Objekt abzurufen. Dieses Objekt enthält den Speicherkontext. Wenn Sie diesen Parameter angeben, geben Sie nicht den Context-Parameter an.
Typ: | CloudFileShare |
Aliase: | CloudFileShare |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ShareClient
Das ShareClient-Objekt hat die Freigabe angegeben, in der die Datei entfernt wurde.
Typ: | ShareClient |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ShareDirectoryClient
Das ShareDirectoryClient-Objekt hat den Basisordner angegeben, in dem die Datei entfernt wurde.
Typ: | ShareDirectoryClient |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ShareFileClient
Das ShareFileClient-Objekt hat angegeben, dass die Datei entfernt wurde.
Typ: | ShareFileClient |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ShareName
Gibt den Namen der Dateifreigabe an. Mit diesem Cmdlet wird die Datei in der Freigabe entfernt, die dieser Parameter angibt.
Typ: | String |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |