Partager via

Remove-CMDistributionPoint

  • Référence
Module:
ConfigurationManager

Supprime un point de distribution.

Syntaxe

Remove-CMDistributionPoint
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDistributionPoint
      [-Force]
      [-SiteCode <String>]
      [-SiteSystemServerName] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-CMDistributionPoint supprime un point de distribution. Lorsque vous supprimez un point de distribution, vous supprimez la désignation d’un serveur de système de site pour fonctionner en tant que centre de distribution pour les fichiers de contenu pour les applications, les packages, les mises à jour logicielles et le déploiement du système d’exploitation.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Supprimer un point de distribution à l’aide du pipeline

PS XYZ:\> Get-CMDistributionPoint -SiteSystemServerName "MySiteSys_11310.Contoso.com" | Remove-CMDistributionPoint -Force

Cette commande obtient l’objet de point de distribution pour le serveur de système de site nommé MySiteSys_11310.Contoso.com et utilise l’opérateur de pipeline pour passer l’objet à Remove-CMDistributionPoint, ce qui supprime l’objet de point de distribution. La spécification du paramètre Force indique que l’utilisateur n’est pas invité avant la suppression du point de distribution.

Exemple 2 : Supprimer un point de distribution à l’aide d’une variable objet

PS XYZ:\> $DP = Get-CMDistributionPoint -SiteSystemServerName "MySiteSys_11310.Contoso.com"
PS XYZ:\> Remove-CMDistributionPoint -InputObject $DP -Force

La première commande obtient l’objet de point de distribution pour le serveur de système de site nommé MySiteSys_11310.Contoso.com et stocke l’objet dans la variable $DP.

La deuxième commande supprime le point de distribution stocké dans $DP. La spécification du paramètre Force indique que l’utilisateur n’est pas invité avant la suppression du point de distribution.

Paramètres

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie un objet de point de distribution. Pour obtenir un objet de point de distribution, utilisez l’applet de commande Get-CMDistributionPoint .

Type:IResultObject
Alias:DistributionPoint
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SiteCode

Spécifie le code de site pour le site Configuration Manager qui héberge ce rôle de système de site.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-SiteSystemServerName

Spécifie le nom de domaine complet du serveur qui héberge le rôle de système de site.

Type:String
Alias:Name, ServerName
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject