Remove-AzRmStorageShare

Odwołanie

Moduł:: Az.Storage

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.

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

-DefaultProfile

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

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

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

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

-InputObject

Obiekt udziału magazynu

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

-Name

Nazwa udziału

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

-PassThru

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

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

-ResourceGroupName

Nazwa grupy zasobów.

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

-ResourceId

Wprowadź identyfikator zasobu udziału plików.

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

-SnapshotTime

Udostępnianie migawkiTime

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

-StorageAccount

Obiekt konta magazynu

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

-StorageAccountName

Nazwa konta magazynu.

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

-WhatIf

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

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

Dane wejściowe

String

PSStorageAccount

PSShare

Dane wyjściowe

Boolean