Freigeben über

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 mindestens ein Clientgerät. Sie müssen ein Gerät vom zugewiesenen Standort des Clients blockieren. Sie können das Gerät nicht an Standorten blockieren, die höher in der Hierarchie liegen. Blockierte Geräte werden von der Configuration Manager-Hierarchie ignoriert. Verwenden Sie zum Aufheben der Blockierung eines Geräts das Cmdlet Unblock-CMDevice .

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . 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 und Blockieren eines Geräts

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.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceId

Gibt die ID eines Geräts an.

Typ:String
Aliase:ResourceId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceName

Gibt den Namen eines Geräts an.

Typ:String
Aliase:Name
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

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

Typ:IResultObject
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object