Dela via


Remove-CMCollection

SYNOPSIS

Tar bort en Konfigurationshanteraren samling.

SYNTAX

SearchByValueMandatory (standard)

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

SearchByIdMandatory

Remove-CMCollection [-Force] -Id <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

SearchByNameMandatory

Remove-CMCollection [-Force] -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DESCRIPTION

Cmdleten Remove-CMCollection tar bort en samling från Konfigurationshanteraren.

Konfigurationshanteraren samlingar är ett sätt att hantera användare, datorer och andra resurser i din organisation. De ger dig inte bara möjlighet att organisera dina resurser, utan ger dig också möjlighet att distribuera Konfigurationshanteraren paket till klienter och användare.

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 angiven samling

PS XYZ:\> Remove-CMCollection -Name "testUser" -Force

Det här kommandot tar bort samlingen med namnet testUser. Att ange force-parametern innebär att användaren inte uppmanas att bekräfta innan samlingen tas bort.

Exempel 2: Hämta ett samlingsobjekt och ta bort det

PS XYZ:\> Get-CMCollection -Name "testUser" | Remove-CMCollection -Force

Det här kommandot hämtar samlingsobjektet med namnet testUser och använder pipelineoperatorn för att skicka objektet till Remove-CMCollection, vilket tar bort samlingen. Att ange force-parametern innebär att användaren inte uppmanas att bekräfta innan samlingen 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

-Id

Anger ett samlings-ID.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: CollectionId

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

-InputObject

Anger ett samlingsobjekt. Om du vill hämta ett samlingsobjekt använder du cmdleten Get-CMCollection.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-Name

Anger namnet på en samling.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-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

System.Object

ANTECKNINGAR

Get-CMCollection

Export-CMCollection

Import-CMCollection

New-CMCollection

Set-CMCollection