다음을 통해 공유


Remove-AzRmStorageShare

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

구문

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을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

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

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Include

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

형식:String
허용되는 값:None, Snapshots, Leased-Snapshots
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

스토리지 공유 개체

형식:PSShare
별칭:Share
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

공유 이름

형식:String
별칭:N, ShareName
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ResourceGroupName

리소스 그룹 이름.

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ResourceId

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

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-SnapshotTime

SnapshotTime 공유

형식:Nullable<T>[DateTime]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-StorageAccount

Storage 계정 개체

형식:PSStorageAccount
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StorageAccountName

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

형식:String
별칭:AccountName
Position:1
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

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

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

String

PSStorageAccount

PSShare

출력

Boolean