Share via

Remove-AzStorageFile

  • Referenz
Modul:
Az.Storage

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.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 ist 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Gibt einen Azure-Speicherkontext an. Verwenden Sie zum Abrufen eines Speicherkontexts das Cmdlet New-AzStorageContext .

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

Gibt einen Ordner als CloudFileDirectory -Objekt an. Mit diesem Cmdlet wird eine Datei im Ordner entfernt, den dieser Parameter angibt.

Type:CloudFileDirectory
Aliases:CloudFileDirectory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DisAllowTrailingDot

Nicht zulassen, dass nachgestellter Punkt (.) verzeichnis- und Dateinamen suffixiert werden.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:CloudFile
Aliases:CloudFile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Gibt den Pfad einer Datei an. Dieses Cmdlet löscht die Datei, die dieser Parameter angibt.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Gibt die Länge des Timeoutzeitraums für den Serverteil einer Anforderung an.

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:CloudFileShare
Aliases:CloudFileShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareClient

Das ShareClient-Objekt hat die Freigabe angegeben, in der die Datei entfernt wurde.

Type:ShareClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareDirectoryClient

Das ShareDirectoryClient-Objekt hat den Basisordner angegeben, in dem die Datei entfernt wurde.

Type:ShareDirectoryClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareFileClient

Das ShareFileClient-Objekt hat angegeben, dass die Datei entfernt wurde.

Type:ShareFileClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareName

Gibt den Namen der Dateifreigabe an. Mit diesem Cmdlet wird die Datei in der Freigabe entfernt, die dieser Parameter angibt.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Ausgaben

AzureStorageFile