Delen via


Remove-CMDeviceCollectionVariable

SYNOPSIS

Hiermee verwijdert u een variabele voor het verzamelen van apparaten.

SYNTAX

SearchByValueMandatory (standaard)

Remove-CMDeviceCollectionVariable -Collection <IResultObject> [-Force] -VariableName <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByIdMandatory

Remove-CMDeviceCollectionVariable -CollectionId <String> [-Force] -VariableName <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByNameMandatory

Remove-CMDeviceCollectionVariable -CollectionName <String> [-Force] -VariableName <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Met de cmdlet Remove-CMDeviceCollectionVariable wordt een apparaatverzamelingsvariabele verwijderd.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een variabele voor het verzamelen van apparaten verwijderen

PS XYZ:\> $Collection = Get-CMCollection -Name "Device"
PS XYZ:\> Remove-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Force

Met de eerste opdracht haalt u het apparaatverzamelingsobject met de naam Apparaat op en slaat u het object op in $Collection variabele.

Met de tweede opdracht wordt de apparaatverzamelingsvariabele met de naam testTS verwijderd uit de apparaatverzameling die is opgeslagen in $Collection. Het opgeven van de parameter Force geeft aan dat de gebruiker niet wordt gevraagd voordat de variabele wordt verwijderd.

Voorbeeld 2: Een apparaatverzamelingsvariabele verwijderen met behulp van de pijplijn

PS XYZ:\> Get-CMCollection -Name "Device" | Remove-CMDeviceCollectionVariable -VariableName "testTS" -Force

Met deze opdracht wordt het apparaatverzamelingsobject met de naam Apparaat opgeslagen en wordt de pijplijnoperator gebruikt om het object door te geven aan Remove-CMDeviceCollectionVariable, waarmee de variabele voor het verzamelen van apparaten met de naam testTS wordt verwijderd uit het apparaatverzamelingsobject. Het opgeven van de parameter Force geeft aan dat de gebruiker niet wordt gevraagd voordat de variabele wordt verwijderd.

PARAMETERS

-Collection

Hiermee geeft u een apparaatverzamelingsobject op. Gebruik de cmdlet Get-CMCollection om een verzamelingsobject te verkrijgen.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-CollectionId

Hiermee geeft u de id van een apparaatverzameling op.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases:

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

-CollectionName

Hiermee geeft u de naam van een apparaatverzameling op.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Force

Dwingt de opdracht uit te voeren zonder te vragen om bevestiging van de gebruiker.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-VariableName

Hiermee geeft u de naam van een verzamelingsvariabele.

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

Get-CMCollection

Get-CMDeviceCollectionVariable

Set-CMDeviceCollectionVariable

New-CMDeviceCollectionVariable