Dela via


Remove-CMDevice

SYNOPSIS

Tar bort en klientenhet från Konfigurationshanteraren.

SYNTAX

SearchByValueMandatory (standard)

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

SearchByNameMandatory

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

SearchByIdMandatory

Remove-CMDevice [-Force] [-ResourceId] <Int32> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DESCRIPTION

Cmdleten Remove-CMDevice tar bort en eller Konfigurationshanteraren klientenheter. Ta inte bort en klient om du vill avinstallera klienten eller ta bort den från en samling.

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 enhet efter namn

PS XYZ:\> Remove-CMDevice -DeviceName "WIN10-86-33"

Det här kommandot tar bort enheten med namnet WIN10-86-33.

Exempel 2: Hämta en enhet och ta bort den

PS XYZ:\> Get-CMDevice -Name "TestVLAN-VNEXT" | Remove-CMDevice

Det här kommandot hämtar enhetsobjektet med namnet TestVLAN-VNEXT och använder pipelineoperatorn för att skicka objektet till Remove-CMDevice, vilket tar bort enhetsobjektet.

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 enhetsobjekt. Om du vill hämta ett enhetsobjekt använder du cmdleten Get-CMDevice.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-Name

Anger namnet på en enhet.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: DeviceName

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

-ResourceId

Anger resurs-ID för en enhet.

Type: Int32
Parameter Sets: SearchByIdMandatory
Aliases: Id, DeviceId

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

System.Object

ANTECKNINGAR

Approve-CMDevice

Block-CMDevice

Get-CMDevice

Avblockera CMDevice