Block-CMDevice

Referenz

Modul:: ConfigurationManager

Blockiert ein Gerät.

Syntax

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

Block-CMDevice
     -DeviceId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Block-CMDevice
     -DeviceName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Das Cmdlet "Block-CMDevice" blockiert ein oder mehrere Clientgeräte. Sie müssen ein Gerät vom zugewiesenen Standort des Clients blockieren. Sie können das Gerät nicht an Standorten in der Hierarchie blockieren, die höher sind. Blockierte Geräte werden von der Configuration Manager-Hierarchie ignoriert. Um die Blockierung eines Geräts aufzuheben, verwenden Sie das Cmdlet "Unblock-CMDevice".

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Blockieren eines Geräts

PS XYZ:\>Block-CMDevice -DeviceName "CMCEN-DIST02"

Dieser Befehl blockiert das Gerät mit dem Namen Test-DIST02.

Beispiel 2: Abrufen eines Geräts und Blockieren

PS XYZ:\> Get-CMDevice -Name "WIN10-86-33" | Block-CMDevice

Dieser Befehl ruft das Geräteobjekt mit dem Namen WIN10-86-33 ab und verwendet den Pipelineoperator, um das Objekt an das Cmdlet "Block-CMDevice" zu übergeben, das das Geräteobjekt blockiert.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceId

Gibt die ID eines Geräts an.

Type:	String
Aliases:	ResourceId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceName

Gibt den Namen eines Geräts an.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-InputObject

Gibt ein Geräteobjekt an. Verwenden Sie zum Abrufen eines Geräteobjekts das Cmdlet "Get-CMDevice".

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object