Remove-CMDistributionPoint

  • Referência
Módulo:
ConfigurationManager

Remove um ponto de distribuição.

Sintaxe

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. Quando remove um ponto de distribuição, remove a designação de um servidor do sistema de sites para funcionar como um centro de distribuição para ficheiros de conteúdo para aplicações, pacotes, atualizações de software e implementação do sistema operativo.

Observação

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

Exemplos

Exemplo 1: Remover um ponto de distribuição com o pipeline

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

Este comando obtém o objeto de ponto de distribuição para o servidor do sistema de sites com o nome MySiteSys_11310.Contoso.com e utiliza o operador de pipeline para transmitir o objeto para Remove-CMDistributionPoint, que remove o objeto do ponto de distribuição. Especificar o parâmetro Force indica que o utilizador não é solicitado antes de o ponto de distribuição ser removido.

Exemplo 2: Remover um ponto de distribuição com 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 do ponto de distribuição para o servidor do sistema de sites com o nome MySiteSys_11310.Contoso.com e armazena o objeto na variável $DP.

O segundo comando remove o ponto de distribuição armazenado no $DP. Especificar o parâmetro Force indica que o utilizador não é solicitado antes de o ponto de distribuição ser removido.

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Força o comando a ser executado sem pedir a confirmação do utilizador.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

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

Tipo:IResultObject
Aliases:DistributionPoint
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SiteCode

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-SiteSystemServerName

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

Tipo:String
Aliases:Name, ServerName
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject