Dela via


Remove-AzStorageFile

Tar bort en fil.

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>]

Description

Cmdleten Remove-AzStorageFile tar bort en fil.

Exempel

Exempel 1: Ta bort en fil från en filresurs

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

Det här kommandot tar bort filen med namnet ContosoFile22 från filresursen med namnet ContosoShare06.

Exempel 2: Hämta en fil från en filresurs med hjälp av ett filresursobjekt

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

Det här kommandot använder cmdleten Get-AzStorageShare för att hämta filresursen ContosoShare06 och skickar sedan objektet till den aktuella cmdleten med hjälp av pipelineoperatorn. Det aktuella kommandot tar bort filen med namnet ContosoFile22 från ContosoShare06.

Parametrar

-ClientTimeoutPerRequest

Anger tidsgränsen på klientsidan i sekunder för en tjänstbegäran. Om det föregående anropet misslyckas i det angivna intervallet försöker den här cmdleten skicka begäran igen. Om den här cmdleten inte får något lyckat svar innan intervallet förflutit returnerar den här cmdleten ett fel.

Typ:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Anger maximalt antal samtidiga nätverksanrop. Du kan använda den här parametern för att begränsa samtidigheten för att begränsa den lokala processor- och bandbreddsanvändningen genom att ange det maximala antalet samtidiga nätverksanrop. Det angivna värdet är ett absolut antal och multipliceras inte med kärnantalet. Den här parametern kan bidra till att minska problem med nätverksanslutningar i miljöer med låg bandbredd, till exempel 100 kilobit per sekund. Standardvärdet är 10.

Typ:Nullable<T>[Int32]
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Aliases:cf
Position:Named
standardvärde:False
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Anger en Azure Storage-kontext. Om du vill hämta en lagringskontext använder du cmdleten New-AzStorageContext .

Typ:IStorageContext
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

Anger en mapp som ett CloudFileDirectory-objekt . Den här cmdleten tar bort en fil i mappen som den här parametern anger.

Typ:CloudFileDirectory
Aliases:CloudFileDirectory
Position:0
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-DisAllowTrailingDot

Tillåt inte avslutande punkt (.) till suffixkatalog och filnamn.

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-File

Anger en fil som ett CloudFile-objekt . Den här cmdleten tar bort filen som den här parametern anger. Om du vill hämta ett CloudFile-objekt använder du cmdleten Get-AzStorageFile.

Typ:CloudFile
Aliases:CloudFile
Position:0
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Anger att den här cmdleten returnerar ett booleskt värde som återspeglar åtgärdens framgång. Som standard returnerar den här cmdleten inte något värde.

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Anger sökväg till en fil. Den här cmdleten tar bort filen som den här parametern anger.

Typ:String
Position:1
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Anger längden på tidsgränsen för serverdelen av en begäran.

Typ:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Share

Anger ett CloudFileShare-objekt . Den här cmdleten tar bort filen i den resurs som den här parametern anger. Om du vill hämta ett CloudFileShare-objekt använder du cmdleten Get-AzStorageShare. Det här objektet innehåller lagringskontexten. Om du anger den här parametern ska du inte ange parametern Kontext .

Typ:CloudFileShare
Aliases:CloudFileShare
Position:0
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareClient

ShareClient-objektet angav resursen där filen skulle tas bort.

Typ:ShareClient
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareDirectoryClient

ShareDirectoryClient-objektet angav den basmapp där filen skulle tas bort.

Typ:ShareDirectoryClient
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareFileClient

ShareFileClient-objektet angav att filen skulle tas bort.

Typ:ShareFileClient
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareName

Anger namnet på filresursen. Den här cmdleten tar bort filen i den resurs som den här parametern anger.

Typ:String
Position:0
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Aliases:wi
Position:Named
standardvärde:False
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Utdata

AzureStorageFile