Delen via

Remove-AzRmStorageShare

  • Referentie
Module:
Az.Storage

Hiermee verwijdert u een opslagbestandsshare.

Syntaxis

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

De cmdlet New-AzRmStorageShare verwijdert een Storage-bestandsshare.

Voorbeelden

Voorbeeld 1: Een opslagbestandsshare verwijderen met de naam van het opslagaccount en de naam van de share

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

Met deze opdracht verwijdert u een Opslagbestandsshare met de naam van het opslagaccount en de naam van de share.

Voorbeeld 2: Een opslagbestandsshare verwijderen met het opslagaccountobject en de naam van de share

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

Met deze opdracht verwijdert u een opslagbestandsshare met het opslagaccountobject en de naam van de share.

Voorbeeld 3: Verwijder alle opslagbestandsshares in een opslagaccount met pijplijn

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

Met deze opdracht verwijdert u alle Opslagbestandsshares in een Opslagaccount met pijplijn.

Voorbeeld 4: Een momentopname van één opslagbestandsshare verwijderen

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

Met deze opdracht verwijdert u één momentopname van de opslagbestandsshare met de specifieke naam en tijd van de momentopname

Voorbeeld 5: Een opslagbestandsshare verwijderen en de momentopnamen zijn

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

Met deze opdracht wordt een Opslagbestandsshare verwijderd en worden er standaard momentopnamen van de cmdlet uitgevoerd als de bestandsshare momentopnamen bevat zonder parameter '-include'.

Voorbeeld 6: Een opslagbestandsshare en alle momentopnamen verwijderen (inclusief geleasede momentopnamen)

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

Met deze opdracht verwijdert u een opslagbestandsshare en alle momentopnamen, inclusief geleasede en niet geleasede momentopnamen. De cmdlet mislukt standaard als de bestandsshare momentopnamen bevat zonder parameter '-include'.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Forceren om de share(momentopname) en alle inhoud erin te verwijderen

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Include

Geldige waarden zijn: momentopnamen, lease-momentopnamen, geen. De standaardwaarde is geen. Als de bestandsshare geen momentopnamen bevat, wordt de bestandsshare verwijderd. Als de bestandsshare momentopnamen bevat (geleased of niet-uitgebracht), mislukt de verwijdering. Voor 'momentopnamen' wordt de bestandsshare verwijderd, inclusief alle momentopnamen van de bestandsshare. Als de bestandsshare geleasede momentopnamen bevat, mislukt de verwijdering. Voor 'leased-snapshots' wordt de bestandsshare verwijderd, inclusief alle momentopnamen van bestandsshares (leased/unleased).

Type:String
Geaccepteerde waarden:None, Snapshots, Leased-Snapshots
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Opslagshareobject

Type:PSShare
Aliassen:Share
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Naam van share

Type:String
Aliassen:N, ShareName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Geeft aan dat deze cmdlet een Booleaanse retourneert die het succes van de bewerking weerspiegelt. Deze cmdlet retourneert standaard geen waarde.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Naam van resourcegroep.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceId

Voer de resource-id van een bestandsshare in.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SnapshotTime

SnapshotTime delen

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StorageAccount

Opslagaccountobject

Type:PSStorageAccount
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-StorageAccountName

Naam van opslagaccount.

Type:String
Aliassen:AccountName
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Uitvoerwaarden