Lezen in het Engels

Delen via

Remove-AzStorageFile

  • Referentie
Module:
Az.Storage

Hiermee verwijdert u een bestand.

Syntaxis

PowerShell 
Remove-AzStorageFile
      [-ShareName] <String>
      [-Path] <String>
      [-PassThru]
      [-DisAllowTrailingDot]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Remove-AzStorageFile
      [-ShareClient] <ShareClient>
      [-Path] <String>
      [-PassThru]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Remove-AzStorageFile
      [-ShareDirectoryClient] <ShareDirectoryClient>
      [-Path] <String>
      [-PassThru]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Remove-AzStorageFile
      [-ShareFileClient] <ShareFileClient>
      [-PassThru]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Met de Remove-AzStorageFile cmdlet wordt een bestand verwijderd.

Voorbeelden

Voorbeeld 1: Een bestand verwijderen uit een bestandsshare

PowerShell 
Remove-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoFile22"

Met deze opdracht verwijdert u het bestand met de naam ContosoFile22 uit de bestandsshare met de naam ContosoShare06.

Voorbeeld 2: Een bestand ophalen uit een bestandsshare met behulp van een bestandsshareobject

PowerShell 
Get-AzStorageShare -Name "ContosoShare06" | Remove-AzStorageFile -Path "ContosoFile22"

Deze opdracht maakt gebruik van de cmdlet Get-AzStorageShare om de bestandsshare met de naam ContosoShare06 op te halen en geeft dat object vervolgens door aan de huidige cmdlet met behulp van de pijplijnoperator. Met de huidige opdracht wordt het bestand met de naam ContosoFile22 verwijderd uit ContosoShare06.

Parameters

-ClientTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de clientzijde op, in seconden, voor één serviceaanvraag. Als de vorige aanroep mislukt in het opgegeven interval, probeert deze cmdlet de aanvraag opnieuw uit te voeren. Als deze cmdlet geen geslaagd antwoord ontvangt voordat het interval is verstreken, retourneert deze cmdlet een fout.

Type:Nullable<T>[Int32]
Aliassen:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConcurrentTaskCount

Hiermee geeft u het maximum aantal gelijktijdige netwerkaanroepen op. U kunt deze parameter gebruiken om de gelijktijdigheid te beperken om het lokale CPU- en bandbreedtegebruik te beperken door het maximum aantal gelijktijdige netwerkaanroepen op te geven. De opgegeven waarde is een absoluut aantal en wordt niet vermenigvuldigd met het aantal kernen. Deze parameter kan helpen bij het verminderen van netwerkverbindingsproblemen in omgevingen met lage bandbreedte, zoals 100 kilobits per seconde. De standaardwaarde is 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Context

Hiermee geeft u een Azure-opslagcontext op. Gebruik de cmdlet New-AzStorageContext om een opslagcontext te verkrijgen.

Type:IStorageContext
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisAllowTrailingDot

Volg punt (.) niet toe om achtervoegselmap en bestandsnamen te achtervoegsel.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Geeft aan dat deze cmdlet een Booleaanse retourneert die het succes van de bewerking weerspiegelt. Deze cmdlet retourneert standaard geen waarde.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Hiermee geeft u het pad van een bestand. Met deze cmdlet wordt het bestand verwijderd dat met deze parameter wordt opgegeven.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServerTimeoutPerRequest

Hiermee geeft u de lengte van de time-outperiode voor het serveronderdeel van een aanvraag.

Type:Nullable<T>[Int32]
Aliassen:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ShareClient

ShareClient-object geeft de share aan waar het bestand zou worden verwijderd.

Type:ShareClient
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ShareDirectoryClient

ShareDirectoryClient-object heeft de basismap aangegeven waarin het bestand zou worden verwijderd.

Type:ShareDirectoryClient
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ShareFileClient

ShareFileClient-object geeft aan dat het bestand wordt verwijderd.

Type:ShareFileClient
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ShareName

Hiermee geeft u de naam van de bestandsshare. Met deze cmdlet verwijdert u het bestand in de share die met deze parameter wordt opgegeven.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Uitvoerwaarden