New-CMTSRule

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie eine Regel, die einem Tasksequenzschritt "Dynamische Variablen festlegen" hinzugefügt werden soll.

Syntax

New-CMTSRule
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-AssetTag <String>]
   [-MacAddress <String>]
   [-SerialNumber <String>]
   [-Uuid <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-DefaultGateway <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-Make <String>]
   [-Model <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-ReferencedVariableName <String>]
   [-ReferencedVariableOperator <VariableOperatorType>]
   [-ReferencedVariableValue <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Regelobjekt zu erstellen, das Sie einem Tasksequenzschritt "Dynamische Variablen festlegen" hinzufügen. Verwenden Sie zum Hinzufügen von Regeln die Cmdlets New-CMTSStepSetDynamicVariable oder Set-CMTSStepSetDynamicVariable. Wenn die Tasksequenz diesen Schritt ausführt, werden die dynamischen Regeln und Variablen in der angegebenen Reihenfolge ausgewertet. Wenn die Regeln auf dem jeweiligen Gerät ausgewertet werden, können tasksequenzvariablen basierend auf diesen Regeln festgelegt werden.

Es gibt vier Arten von Regeln:

  • Computer: Werte für Hardwareressourcen-Tag, UUID, Seriennummer oder MAC-Adresse auswerten.
  • Speicherort: Werte für das Standardnetzwerkgateway auswerten.
  • Make and Model: Werte für die Art und das Modell eines Computers auswerten.
  • Tasksequenzvariable: Fügen Sie eine Tasksequenzvariable, eine Bedingung und einen Wert hinzu, die ausgewertet werden sollen.

Weitere Informationen finden Sie unter Dynamische Regeln und Variablen.

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: Festlegen des Downloadziels in Windows PE

In diesem Beispiel wird die folgende Regel erstellt:

IF _SMSTSInWinPE equals "TRUE" THEN SET OSDDownloadDestinationLocationType = "TSCache"

Anschließend wird diese Regel einer vorhandenen Instanz dieses Schritts in einer Tasksequenz hinzugefügt.

$tsrule = New-CMTSRule -Variable @{'OSDDownloadDestinationLocationType' = 'TSCache'} -ReferencedVariableName "_SMSTSInWinPE" -ReferencedVariableOperator equals -ReferencedVariableValue TRUE

$tsname = "Default IPU"
$tsstep = "Set Dynamic Variables"

Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsname -StepName $tsstep -AddRule $tsrule

Parameter

-AssetTag

Geben Sie ein Asset-Tag für den Computerregeltyp an. Der Maximalwert beträgt 255 Zeichen.

Wenn Sie diesen Wert beispielsweise 123456 festlegen, wird die folgende Regel hinzugefügt: IF Asset tag equals "123456" THEN

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

-Confirm

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

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

-DefaultGateway

Geben Sie das Standardgateway für den Positionsregeltyp an.

Wenn Sie diesen Wert beispielsweise 192.168.10.1 festlegen, wird die folgende Regel hinzugefügt: IF Default gateway equals "192.168.10.1" THEN

Type:String
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

-MacAddress

Geben Sie die MAC-Adresse für den Computerregeltyp an.

Wenn Sie diesen Wert beispielsweise 00:11:22:33:44:55 festlegen, wird die folgende Regel hinzugefügt: IF MAC address equals "00:11:22:33:44:55" THEN

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

-Make

Geben Sie den Regeltyp Make for the Make und Model an. Verwenden Sie zum Festlegen des anderen Werts den Parameter "Model". Die Regel wertet "true" aus, wenn beide Werte "true" sind.

Sie können Platzhalterzeichen verwenden:

  • *: Mehrere Zeichen
  • ?: Einzelnes Zeichen

Wenn Sie z. B. diesen Wert Surface und das Modell * festlegen, wird die folgende Regel hinzugefügt: IF Make equals "Surface" AND Model equals "*" THEN

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

-Model

Geben Sie das Modell für den Regeltyp Make und Model an. Verwenden Sie zum Festlegen des anderen Werts den Parameter "Make". Die Regel wertet "true" aus, wenn beide Werte "true" sind.

Sie können Platzhalterzeichen verwenden:

  • *: Mehrere Zeichen
  • ?: Einzelnes Zeichen

Wenn Sie diesen Wert z. B. auf * "Make" und "Make" Surface festlegen, wird die folgende Regel hinzugefügt: IF Make equals "Surface" AND Model equals "*" THEN

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

-ReferencedVariableName

Geben Sie die Variable für den Regeltyp TaskSequenzvariable an. Es erfordert, dass Sie auch die Parameter ReferencedVariableOperator und ReferencedVariableValue festlegen.

Bei diesem Variablennamen kann es sich um eine integrierte Tasksequenzvariable oder eine benutzerdefinierte Variable handeln, die Sie erstellt haben. Weitere Informationen finden Sie unter Verwenden von Tasksequenzvariablen in Configuration Manager.

Wenn Sie beispielsweise die folgenden Werte festlegen:

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator:Equals
  • ReferencedVariableValue: Contoso

Anschließend wird die folgende Regel hinzugefügt: IF OSDRegisteredOrgName equals "Contoso" THEN

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

-ReferencedVariableOperator

Geben Sie die Bedingung für den Regeltyp TaskSequenzvariable an. Es erfordert, dass Sie auch die Parameter ReferencedVariableName und ReferencedVariableValue festlegen. Die verfügbaren Operatoren finden Sie in der Liste der akzeptierten Werte für diesen Parameter.

Wenn Sie beispielsweise die folgenden Werte festlegen:

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator:Equals
  • ReferencedVariableValue: Contoso

Anschließend wird die folgende Regel hinzugefügt: IF OSDRegisteredOrgName equals "Contoso" THEN

Type:VariableOperatorType
Accepted values:Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ReferencedVariableValue

Geben Sie den Wert für den Regeltyp Task Sequence Variable an. Sie müssen außerdem die Parameter ReferencedVariableName und ReferencedVariableOperator festlegen.

Wenn Sie beispielsweise die folgenden Werte festlegen:

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator:Equals
  • ReferencedVariableValue: Contoso

Anschließend wird die folgende Regel hinzugefügt: IF OSDRegisteredOrgName equals "Contoso" THEN

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

-SerialNumber

Geben Sie eine Seriennummer für den Computerregeltyp an.

Wenn Sie diesen Wert beispielsweise 123456 festlegen, wird die folgende Regel hinzugefügt: IF Asset tag equals "123456" THEN

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

-Uuid

Geben Sie eine UUID für den Computerregeltyp an.

Wenn Sie diesen Wert beispielsweise de5ba380-f692-45e0-bbd3-0e40543b549e festlegen, wird die folgende Regel hinzugefügt: IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN

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

-Variable

Geben Sie die vorhandenen oder benutzerdefinierten Tasksequenzvariablen und zugehörigen Werte an, die der Schritt festlegen soll, wenn die Regel als "true" ausgewertet wird.

Wenn Sie diesen Wert beispielsweise auf @{'OSDDownloadDestinationLocationType' = 'TSCache'} festlegen, wird die folgende Variable nach der THEN Regel hinzugefügt: SET OSDDownloadDestinationLocationType = "TSCache"

Wenn Sie mehrere Variablen in derselben Hashtabelle angeben möchten, verwenden Sie ein Semikolon ; ()-Trennzeichen. Beispiel: @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}

Type:Hashtable
Aliases:Variables
Position:Named
Default value:None
Accept pipeline input:False
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:None
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Keine

Ausgaben

IResultObject