Share via

Remove-CMDistributionPoint

  • Referência
Módulo:
ConfigurationManager

Remove um ponto de distribuição.

Syntax

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

Description

O cmdlet Remove-CMDistributionPoint remove um ponto de distribuição. Ao remover um ponto de distribuição, você remove a designação de um servidor do sistema de sites para funcionar como um centro de distribuição para arquivos de conteúdo para aplicativos, pacotes, atualizações de software e implantação do sistema operacional.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: remover um ponto de distribuição usando o pipeline

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

Esse comando obtém o objeto ponto de distribuição do servidor do sistema de site chamado MySiteSys_11310.Contoso.com e usa o operador de pipeline para passar o objeto para Remove-CMDistributionPoint, que remove o objeto do ponto de distribuição. Especificar o parâmetro Force indica que o usuário não é solicitado antes que o ponto de distribuição seja removido.

Exemplo 2: remover um ponto de distribuição usando uma variável de objeto

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

O primeiro comando obtém o objeto de ponto de distribuição do servidor do sistema de site chamado MySiteSys_11310.Contoso.com e armazena o objeto na variável $DP.

O segundo comando remove o ponto de distribuição armazenado em $DP. Especificar o parâmetro Force indica que o usuário não é solicitado antes que o ponto de distribuição seja removido.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-InputObject

Especifica um objeto de ponto de distribuição. Para obter um objeto de ponto de distribuição, use o cmdlet Get-CMDistributionPoint .

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

-SiteCode

Especifica o código do site do site Configuration Manager que hospeda essa função do sistema de sites.

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

-SiteSystemServerName

Especifica o FQDN do servidor que hospeda a função do sistema de sites.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject