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
RELATED LINKS
Set-CMTSStepSetDynamicVariable
New-CMTSStepSetDynamicVariable