Sdílet prostřednictvím


New-CMTSRule

SYNOPSIS

Vytvořte pravidlo, které se přidá do kroku pořadí úkolů Nastavit dynamické proměnné.

SYNTAX

VariableOnly (Výchozí)

New-CMTSRule -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Podmínka počítače

New-CMTSRule [-AssetTag <String>] [-MacAddress <String>] [-SerialNumber <String>] [-Uuid <String>]
 -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

LocationCondition

New-CMTSRule [-DefaultGateway <String>] -Variable <Hashtable> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

MakeModelCondition

New-CMTSRule [-Make <String>] [-Model <String>] -Variable <Hashtable> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

ProměnnáPodmínka

New-CMTSRule [-ReferencedVariableName <String>] [-ReferencedVariableOperator <VariableOperatorType>]
 [-ReferencedVariableValue <String>] -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Pomocí této rutiny můžete vytvořit pravidlo, které můžete přidat do kroku pořadí úkolů Nastavit dynamické proměnné. Když pořadí úkolů spustí tento krok, vyhodnotí dynamická pravidla a proměnné v pořadí. Když vyhodnocuje pravidla na konkrétním zařízení, může pak na základě těchto pravidel nastavit proměnné pořadí úkolů.

Existují čtyři typy pravidel:

  • Počítač: Vyhodnotí hodnoty pro značku hardwarového assetu, UUID, sériové číslo nebo adresu MAC.
  • Umístění: Vyhodnotí hodnoty výchozí síťové brány.
  • Značka a Model: Vyhodnotí hodnoty výrobce a modelu počítače.
  • Proměnná pořadí úkolů: Přidejte proměnnou, podmínku a hodnotu pořadí úkolů, které se mají vyhodnotit.

Další informace najdete v tématu Dynamická pravidla a proměnné.

Poznámka

Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: Nastavení cíle stahování v prostředí Windows PE

Tento příklad vytvoří následující pravidlo:

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

Potom toto pravidlo přidá do existující instance tohoto kroku v pořadí úkolů.

$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

PARAMETERS

-AssetTag

Jako Typ pravidla počítače zadejte značku Asset. Maximální hodnota je 255 znaků.

Pokud například nastavíte tuto hodnotu na 123456 , přidá se následující pravidlo: IF Asset tag equals "123456" THEN

Type: String
Parameter Sets: ComputerCondition
Aliases:

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

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

-DefaultGateway

Jako Typ pravidla umístění zadejte Výchozí brána.

Pokud například nastavíte tuto hodnotu na 192.168.10.1 , přidá se následující pravidlo: IF Default gateway equals "192.168.10.1" THEN

Type: String
Parameter Sets: LocationCondition
Aliases:

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

-DisableWildcardHandling

Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-MacAddress

Zadejte adresu MAC pro typ pravidla počítače.

Pokud například nastavíte tuto hodnotu na 00:11:22:33:44:55 , přidá se následující pravidlo: IF MAC address equals "00:11:22:33:44:55" THEN

Type: String
Parameter Sets: ComputerCondition
Aliases:

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

-Make (Vytvořit)

Jako Typ pravidla značka a model zadejte Značka. Pokud chcete nastavit jinou hodnotu, použijte parametr Model. Pravidlo vyhodnotí hodnotu true, pokud jsou obě hodnoty pravdivé.

Můžete použít zástupné znaky:

  • *: Více znaků
  • ?: Jeden znak

Pokud například nastavíte tuto hodnotu na a Surface Model na , přidá se * následující pravidlo: IF Make equals "Surface" AND Model equals "*" THEN

Type: String
Parameter Sets: MakeModelCondition
Aliases:

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

-Model

Jako Typ pravidla značka a model zadejte Model. Pokud chcete nastavit jinou hodnotu, použijte parametr Make. Pravidlo vyhodnotí hodnotu true, pokud jsou obě hodnoty pravdivé.

Můžete použít zástupné znaky:

  • *: Více znaků
  • ?: Jeden znak

Pokud například nastavíte tuto hodnotu na a možnost Nastavit na * , přidá se následující Surface pravidlo:IF Make equals "Surface" AND Model equals "*" THEN

Type: String
Parameter Sets: MakeModelCondition
Aliases:

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

-ReferencedVariableName

Zadejte proměnnou pro typ pravidla Proměnná pořadí úloh. Vyžaduje také nastavení parametrů ReferencedVariableOperator a ReferencedVariableValue.

Tento název proměnné může být integrovaná proměnná pořadí úkolů nebo vlastní proměnná, kterou jste vytvořili. Další informace najdete v tématu Použití proměnných pořadí úkolů v nástroji Správce konfigurace.

Pokud například nastavíte následující hodnoty:

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

Pak přidá následující pravidlo: IF OSDRegisteredOrgName equals "Contoso" THEN

Type: String
Parameter Sets: VariableCondition
Aliases:

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

-ReferencedVariableOperator

Zadejte podmínku pro typ pravidla Proměnná pořadí úloh. Vyžaduje také nastavení parametrů ReferencedVariableName a ReferencedVariableValue. Dostupné operátory najdete v seznamu přijatých hodnot pro tento parametr.

Pokud například nastavíte následující hodnoty:

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

Pak přidá následující pravidlo: IF OSDRegisteredOrgName equals "Contoso" THEN

Type: VariableOperatorType
Parameter Sets: VariableCondition
Aliases:
Accepted values: Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike

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

-ReferencedVariableValue

Zadejte hodnotu pro typ pravidla proměnná pořadí úloh. Vyžaduje také nastavení parametrů ReferencedVariableName a ReferencedVariableOperator.

Pokud například nastavíte následující hodnoty:

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

Pak přidá následující pravidlo: IF OSDRegisteredOrgName equals "Contoso" THEN

Type: String
Parameter Sets: VariableCondition
Aliases:

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

-SerialNumber

Jako Typ pravidla počítače zadejte Sériové číslo.

Pokud například nastavíte tuto hodnotu na 123456 , přidá se následující pravidlo: IF Asset tag equals "123456" THEN

Type: String
Parameter Sets: ComputerCondition
Aliases:

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

-Uuid

Jako Typ pravidla počítače zadejte UUID.

Pokud například nastavíte tuto hodnotu na de5ba380-f692-45e0-bbd3-0e40543b549e , přidá se následující pravidlo: IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN

Type: String
Parameter Sets: ComputerCondition
Aliases:

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

-Variable (Proměnná)

Zadejte existující nebo vlastní proměnné pořadí úkolů a přidružené hodnoty, které má tento krok nastavit, když se pravidlo vyhodnotí jako true.

Pokud například nastavíte tuto hodnotu na , přidá za pravidlo @{'OSDDownloadDestinationLocationType' = 'TSCache'} THEN následující proměnnou: SET OSDDownloadDestinationLocationType = "TSCache"

Pokud chcete zadat více než jednu proměnnou ve stejné zatřiďovací tabulce, použijte středník ( ; ). Příklad: @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}

Type: Hashtable
Parameter Sets: (All)
Aliases: Variables

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespouštěl.

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

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Žádná

OUTPUTS

IResultObject # SMS_TaskSequence_Rule

POZNÁMKY

Set-CMTSStepSetDynamicVariable

New-CMTSStepSetDynamicVariable

Kroky pořadí úkolů – nastavení dynamických proměnných

Použití proměnných pořadí úkolů v Configuration Manager