Dela via


Remove-CMDistributionPoint

SYNOPSIS

Tar bort en distributionsplats.

SYNTAX

SearchByValueMandatory (standard)

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

SearchByNameMandatory

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

DESCRIPTION

Cmdleten Remove-CMDistributionPoint tar bort en distributionsplats. När du tar bort en distributionsplats tar du bort beteckning för en platssystemserver så att den fungerar som ett distributionscenter för innehållsfiler för program, paket, programuppdateringar och operativsystemsdistribution.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Ta bort en distributionsplats med hjälp av pipelinen

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

Det här kommandot hämtar distributionsplatsens objekt för platssystemservern med namnet MySiteSys_11310.Contoso.com och använder pipelineoperatorn för att skicka objektet till Remove-CMDistributionPoint, vilket tar bort distributionsplatsens objekt. Om du anger force-parametern betyder det att användaren inte tillfrågas innan distributionsplatsen tas bort.

Exempel 2: Ta bort en distributionsplats med hjälp av en objektvariabel

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

Det första kommandot hämtar distributionsplatsens objekt för platssystemservern med namnet MySiteSys_11310.Contoso.com och lagrar objektet i $DP variabeln.

Det andra kommandot tar bort distributionsplatsen som lagras i $DP. Om du anger force-parametern betyder det att användaren inte tillfrågas innan distributionsplatsen tas bort.

PARAMETERS

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Anger ett distributionsplatsobjekt. Om du vill hämta ett distributionsplatsobjekt använder du cmdleten Get-CMDistributionPoint.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: DistributionPoint

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-SiteCode

Anger platskoden för den plats Konfigurationshanteraren är värd för den här platssystemrollen.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-SiteSystemServerName

Anger FQDN för den server som är värd för platssystemrollen.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: Name, ServerName

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

ANTECKNINGAR

Add-CMDistributionPoint

Get-CMDistributionPoint

New-CMDistributionPointGroup

Set-CMDistributionPoint

Get-CMDistributionPointGroup

Update-CMDistributionPoint