共用方式為

Remove-AzStorageFile

  • 參考
模組:
Az.Storage

刪除檔案。

語法

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

Description

Remove-AzStorageFile Cmdlet 會刪除檔案。

範例

範例 1：從檔案共享中刪除檔案

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

此命令會從名為 ContosoShare06 的檔案共享中刪除名為 ContosoFile22 的檔案。

範例 2：使用檔案共享物件從檔案共用取得檔案

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

此命令會使用 Get-AzStorageShare Cmdlet 來取得名為 ContosoShare06 的檔案共享，然後使用管線運算符將該對象傳遞至目前的 Cmdlet。 目前的命令會從 ContosoShare06 刪除名為 ContosoFile22 的檔案。

參數

-ClientTimeoutPerRequest

指定一個服務要求的用戶端超時時間間隔，以秒為單位。 如果先前的呼叫在指定的間隔內失敗，此 Cmdlet 會重試要求。 如果此 Cmdlet 在間隔經過之前未收到成功的回應，此 Cmdlet 會傳回錯誤。

類型:Nullable<T>[Int32]
別名:ClientTimeoutPerRequestInSeconds
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ConcurrentTaskCount

指定並行網路呼叫上限。 您可以藉由指定並行網路呼叫數目上限，使用此參數來限制並行 CPU 和頻寬使用量的並行存取。 指定的值是絕對計數，不會乘以核心計數。 此參數可協助減少低頻寬環境中的網路連線問題，例如每秒 100 千位。 預設值為 10。

類型:Nullable<T>[Int32]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Context

指定 Azure 記憶體內容。 若要取得記憶體內容，請使用 New-AzStorageContext Cmdlet。

類型:IStorageContext
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisAllowTrailingDot

不允許尾端點 （.） 後置詞目錄和檔名。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PassThru

指出此 Cmdlet 會傳回反映作業成功的 布爾值。 根據預設，此 Cmdlet 不會傳回值。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Path

指定檔案的路徑。 此 Cmdlet 會刪除此參數指定的檔案。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-ServerTimeoutPerRequest

指定要求的伺服器部分逾時期間長度。

類型:Nullable<T>[Int32]
別名:ServerTimeoutPerRequestInSeconds
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ShareClient

ShareClient 物件指出將移除檔案的共用。

類型:ShareClient
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ShareDirectoryClient

ShareDirectoryClient 物件指出要移除檔案的基底資料夾。

類型:ShareDirectoryClient
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ShareFileClient

ShareFileClient 物件指出檔案將會移除。

類型:ShareFileClient
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ShareName

指定檔案共享的名稱。 這個 Cmdlet 會移除這個參數所指定共用中的檔案。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

ShareClient

ShareDirectoryClient

ShareFileClient

IStorageContext

輸出

AzureStorageFile