Remove-AzStorageFile
刪除檔案。
語法
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
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 |
-Directory
將資料夾指定為 CloudFileDirectory 物件。 這個 Cmdlet 會移除此參數所指定資料夾中的檔案。
類型: | CloudFileDirectory |
別名: | CloudFileDirectory |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-DisAllowTrailingDot
不允許尾端點 (.) 後置詞目錄和檔名。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-File
將檔案指定為 CloudFile 物件。 此 Cmdlet 會移除此參數所指定的檔案。 若要取得 CloudFile 物件,請使用 Get-AzStorageFile Cmdlet。
類型: | CloudFile |
別名: | CloudFile |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-PassThru
指出此 Cmdlet 會傳回 Boolean ,反映作業的成功。 根據預設,此 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 |
-Share
指定 CloudFileShare 物件。 這個 Cmdlet 會移除這個參數所指定共用中的檔案。 若要取得 CloudFileShare 物件,請使用 Get-AzStorageShare Cmdlet。 這個物件包含記憶體內容。 如果您指定此參數,請勿指定 Context 參數。
類型: | CloudFileShare |
別名: | CloudFileShare |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-ShareClient
ShareClient 物件指出將移除檔案的共用。
類型: | ShareClient |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-ShareDirectoryClient
ShareDirectoryClient 物件指出要移除檔案的基底資料夾。
類型: | ShareDirectoryClient |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-ShareFileClient
ShareFileClient 物件指出檔案將會移除。
類型: | ShareFileClient |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-ShareName
指定檔案共享的名稱。 這個 Cmdlet 會移除這個參數所指定共用中的檔案。
類型: | String |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |