Remove-AzRmStorageShare

Module:

Az.Storage Module

Supprime un partage de fichiers de stockage.

Syntaxe

AccountName (Par défaut)

Remove-AzRmStorageShare
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    -Name <String>
    [-Force]
    [-Include <String>]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AccountNameSnapshot

Remove-AzRmStorageShare
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    -Name <String>
    -SnapshotTime <DateTime>
    [-Force]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AccountObject

Remove-AzRmStorageShare
    -Name <String>
    -StorageAccount <PSStorageAccount>
    [-Force]
    [-Include <String>]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AccountObjectSnapshot

Remove-AzRmStorageShare
    -Name <String>
    -StorageAccount <PSStorageAccount>
    -SnapshotTime <DateTime>
    [-Force]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ShareResourceId

Remove-AzRmStorageShare
    [-ResourceId] <String>
    [-Force]
    [-Include <String>]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ShareObject

Remove-AzRmStorageShare
    -InputObject <PSShare>
    [-Force]
    [-Include <String>]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Remove-AzRmStorageShare supprime un partage de fichiers de stockage.

Exemples

Exemple 1 : Supprimer un partage de fichiers de stockage avec le nom du compte de stockage et le nom du partage

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

Cette commande supprime un partage de fichiers de stockage avec le nom du compte de stockage et le nom du partage.

Exemple 2 : Supprimer un partage de fichiers de stockage avec un objet de compte de stockage et un nom de partage

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

Cette commande supprime un partage de fichiers de stockage avec un objet de compte de stockage et un nom de partage.

Exemple 3 : Supprimer tous les partages de fichiers de stockage dans un compte de stockage avec pipeline

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

Cette commande supprime tous les partages de fichiers de stockage dans un compte de stockage avec pipeline.

Exemple 4 : Supprimer un instantané de partage de fichiers de stockage unique

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

Cette commande supprime un instantané de partage de fichiers de stockage unique avec le nom de partage et l’heure d’instantané spécifiques

Exemple 5 : Supprimer un partage de fichiers de stockage et ses instantanés

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

Cette commande supprime un partage de fichiers de stockage et les captures instantanées Par défaut, l’applet de commande échoue si le partage de fichiers comporte des instantanés sans paramètre « -include ».

Exemple 6 : Supprimer un partage de fichiers de stockage et tous ses instantanés (inclure des instantanés loués)

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

Cette commande supprime un partage de fichiers de stockage et tous ses instantanés, y compris les instantanés loués et non loués. Par défaut, l’applet de commande échoue si le partage de fichiers a des instantanés sans paramètre « -include ».

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:	IAzureContextContainer
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Force

Forcer la suppression du partage (instantané) et de tout le contenu dans celui-ci

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Include

Les valeurs valides sont les suivantes : instantanés, instantanés loués, aucun. La valeur par défaut n’est pas. Pour « aucun », le partage de fichiers est supprimé s’il n’a aucun instantané de partage. Si le partage de fichiers contient des instantanés (loués ou non générés), la suppression échoue. Pour « captures instantanées », le partage de fichiers est supprimé, y compris tous ses instantanés de partage de fichiers. Si le partage de fichiers contient des instantanés loués, la suppression échoue. Pour les « captures instantanées louées », le partage de fichiers est supprimé, y compris tous ses instantanés de partage de fichiers (loués/ non légés).

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	None, Snapshots, Leased-Snapshots
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AccountName

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

AccountObject

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

ShareResourceId

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

ShareObject

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-InputObject

Objet De partage de stockage

Propriétés du paramètre

Type:	PSShare
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Share

Jeux de paramètres

ShareObject

Position:	Named
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Name

Nom du partage

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	N, ShareName

Jeux de paramètres

AccountName

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

AccountNameSnapshot

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

AccountObject

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

AccountObjectSnapshot

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-PassThru

Indique que cette applet de commande retourne une valeur booléenne qui reflète la réussite de l’opération. Par défaut, cette applet de commande ne retourne pas de valeur.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ResourceGroupName

Nom du groupe de ressources.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AccountName

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

AccountNameSnapshot

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ResourceId

Entrez un ID de ressource de partage de fichiers.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ShareResourceId

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-SnapshotTime

Partager SnapshotTime

Propriétés du paramètre

Type:	Nullable<T>[DateTime]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AccountNameSnapshot

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

AccountObjectSnapshot

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-StorageAccount

Objet compte de stockage

Propriétés du paramètre

Type:	PSStorageAccount
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AccountObject

Position:	Named
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

AccountObjectSnapshot

Position:	Named
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-StorageAccountName

Nom du compte de stockage.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Nom du compte

Jeux de paramètres

AccountName

Position:	1
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

AccountNameSnapshot

Position:	1
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

PSStorageAccount

PSShare

Sorties

Boolean