Udostępnij za pośrednictwem


Remove-AzRmStorageShare

Usuwa udział plików magazynu.

Składnia

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

Opis

Polecenie cmdlet New-AzRmStorageShare usuwa udział plików magazynu.

Przykłady

Przykład 1. Usuwanie udziału plików magazynu z nazwą konta magazynu i nazwą udziału

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

To polecenie usuwa udział plików usługi Storage z nazwą konta magazynu i nazwą udziału.

Przykład 2. Usuwanie udziału plików magazynu z obiektem konta magazynu i nazwą udziału

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

To polecenie usuwa udział plików usługi Storage z obiektem konta magazynu i nazwą udziału.

Przykład 3. Usuwanie wszystkich udziałów plików magazynu na koncie magazynu przy użyciu potoku

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

To polecenie usuwa wszystkie udziały plików usługi Storage na koncie magazynu z potokiem.

Przykład 4. Usuwanie pojedynczej migawki udziału plików magazynu

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

To polecenie usuwa pojedynczą migawkę udziału plików magazynu z określoną nazwą udziału i czasem migawki

Przykład 5. Usuwanie udziału plików magazynu i jego migawki

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

To polecenie usuwa udział plików magazynu i domyślnie migawki nie powiedzie się, jeśli udział plików zawiera migawki bez parametru "-include".

Przykład 6: Usuwanie udziału plików magazynu i wszystkich migawek (obejmują migawki dzierżawione)

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

To polecenie usuwa udział plików magazynu i wszystkie jego migawki, obejmują dzierżawione i nie dzierżawione migawki. Domyślnie polecenie cmdlet zakończy się niepowodzeniem, jeśli udział plików zawiera migawki bez parametru "-include".

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wymuszanie usunięcia udziału (migawki) i całej zawartości w niej

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Include

Prawidłowe wartości to: migawki, migawki dzierżawione, brak. Wartość domyślna to brak. W przypadku elementu "none" udział plików jest usuwany, jeśli nie ma migawek udziałów. Jeśli udział plików zawiera migawki (dzierżawione lub nieuprawione), usunięcie nie powiedzie się. W przypadku "migawek" udział plików jest usuwany wraz ze wszystkimi migawkami udziału plików. Jeśli udział plików zawiera wydzierżawione migawki, usunięcie zakończy się niepowodzeniem. W przypadku "dzierżawionych migawek" udział plików jest usuwany, dołączane są wszystkie migawki udziału plików (dzierżawione/niezaleaszone).

Typ:String
Dopuszczalne wartości:None, Snapshots, Leased-Snapshots
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Obiekt udziału magazynu

Typ:PSShare
Aliasy:Share
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Nazwa udziału

Typ:String
Aliasy:N, ShareName
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PassThru

Wskazuje, że to polecenie cmdlet zwraca wartość logiczną, która odzwierciedla powodzenie operacji. Domyślnie to polecenie cmdlet nie zwraca wartości.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Nazwa grupy zasobów.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceId

Wprowadź identyfikator zasobu udziału plików.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SnapshotTime

Udostępnianie migawkiTime

Typ:Nullable<T>[DateTime]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-StorageAccount

Obiekt konta magazynu

Typ:PSStorageAccount
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StorageAccountName

Nazwa konta magazynu.

Typ:String
Aliasy:AccountName
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

PSStorageAccount

PSShare

Dane wyjściowe

Boolean