Remove-AzRmStorageShare

스토리지 파일 공유를 제거합니다.

Syntax

Remove-AzRmStorageShare
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      -Name <String>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzRmStorageShare
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      -Name <String>
      -SnapshotTime <DateTime>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      -SnapshotTime <DateTime>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzRmStorageShare
      [-ResourceId] <String>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzRmStorageShare
      -InputObject <PSShare>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

New-AzRmStorageShare cmdlet은 스토리지 파일 공유를 제거합니다.

예제

예제 1: Storage 계정 이름 및 공유 이름을 사용하여 스토리지 파일 공유 제거

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare"

이 명령은 Storage 계정 이름 및 공유 이름을 사용하여 Storage 파일 공유를 제거합니다.

예제 2: Storage 계정 개체 및 공유 이름을 사용하여 Storage 파일 공유 제거

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount"
Remove-AzRmStorageShare -StorageAccount $accountObject -Name "myshare"

이 명령은 Storage 계정 개체 및 공유 이름을 사용하여 Storage 파일 공유를 제거합니다.

예제 3: 파이프라인을 사용하여 Storage 계정의 모든 Storage 파일 공유 제거

Get-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" | Remove-AzRmStorageShare -Force

이 명령은 파이프라인이 있는 Storage 계정의 모든 Storage 파일 공유를 제거합니다.

예제 4: 단일 Storage 파일 공유 제거 스냅샷

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -SnapshotTime "2021-05-10T08:04:08Z"

이 명령은 특정 공유 이름과 스냅샷 시간으로 단일 Storage 파일 공유 스냅샷 제거합니다.

예제 5: 스토리지 파일 공유 제거 및 스냅샷

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -Include Snapshots

이 명령은 스토리지 파일 공유를 제거하고 스냅샷 기본적으로 파일 공유에 "-include" 매개 변수가 없는 스냅샷 있으면 cmdlet이 실패합니다.

예제 6: 스토리지 파일 공유 및 모든 스냅샷 제거(임대 스냅샷 포함)

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -Include Leased-Snapshots

이 명령은 스토리지 파일 공유를 제거하고 모든 스냅샷 임대 및 임대되지 않은 스냅샷 포함합니다. 기본적으로 파일 공유에 "-include" 매개 변수가 없는 스냅샷 있으면 cmdlet이 실패합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

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

-Force

공유(스냅샷) 및 해당 공유의 모든 콘텐츠를 강제로 제거합니다.

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

-Include

유효한 값은 스냅샷, 임대 스냅샷, 없음입니다. 기본값은 none입니다. 'none'의 경우 공유 스냅샷 없는 경우 파일 공유가 삭제됩니다. 파일 공유에 스냅샷s(임대 또는 해제)가 포함되어 있으면 삭제가 실패합니다. '스냅샷s'의 경우 모든 파일 공유 스냅샷 포함하여 파일 공유가 삭제됩니다. 파일 공유에 임대된 스냅샷 포함되어 있으면 삭제가 실패합니다. 'leased-스냅샷s'의 경우 파일 공유는 모든 파일 공유 스냅샷 포함됩니다(임대/임대되지 않음).

Type:String
Accepted values:None, Snapshots, Leased-Snapshots
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

스토리지 공유 개체

Type:PSShare
Aliases:Share
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

공유 이름

Type:String
Aliases:N, ShareName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

이 cmdlet은 작업의 성공을 반영하는 부울을 반환한다는 것을 나타냅니다. 기본적으로 이 cmdlet은 값을 반환하지 않습니다.

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

-ResourceGroupName

리소스 그룹 이름.

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

-ResourceId

파일 공유 리소스 ID를 입력합니다.

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

-SnapshotTime

SnapshotTime 공유

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

-StorageAccount

Storage 계정 개체

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

-StorageAccountName

스토리지 계정 이름입니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

String

PSStorageAccount

PSShare

출력

Boolean