Remove-CMDistributionPoint

  • Referencia
Módulo:
ConfigurationManager

Quita un punto de distribución.

Syntax

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

Description

El cmdlet Remove-CMDistributionPoint quita un punto de distribución. Al quitar un punto de distribución, se quita la designación de un servidor de sistema de sitio para que funcione como centro de distribución de archivos de contenido para aplicaciones, paquetes, actualizaciones de software e implementación del sistema operativo.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Eliminación de un punto de distribución mediante la canalización

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

Este comando obtiene el objeto de punto de distribución para el servidor de sistema de sitio denominado MySiteSys_11310.Contoso.com y usa el operador de canalización para pasar el objeto a Remove-CMDistributionPoint, lo que quita el objeto de punto de distribución. La especificación del parámetro Force indica que no se solicita al usuario antes de quitar el punto de distribución.

Ejemplo 2: Eliminación de un punto de distribución mediante una variable de objeto

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

El primer comando obtiene el objeto de punto de distribución para el servidor de sistema de sitio denominado MySiteSys_11310.Contoso.com y almacena el objeto en la variable $DP.

El segundo comando quita el punto de distribución almacenado en $DP. La especificación del parámetro Force indica que no se solicita al usuario antes de quitar el punto de distribución.

Parámetros

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

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

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-Force

Obliga al comando a ejecutarse sin pedir confirmación del usuario.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-InputObject

Especifica un objeto de punto de distribución. Para obtener un objeto de punto de distribución, use el cmdlet Get-CMDistributionPoint .

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

-SiteCode

Especifica el código de sitio para el sitio Configuration Manager que hospeda este rol de sistema de sitio.

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

-SiteSystemServerName

Especifica el FQDN del servidor que hospeda el rol de sistema de sitio.

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

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject