New-CMTSRule
SYNOPSIS
Hozzon létre egy szabályt, amely hozzáadható a Dinamikus változók beállítása feladatütemezési lépéshez.
SYNTAX
VariableOnly (alapértelmezett)
New-CMTSRule -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
ComputerCondition (Számítógép-igénylés)
New-CMTSRule [-AssetTag <String>] [-MacAddress <String>] [-SerialNumber <String>] [-Uuid <String>]
-Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
LocationCondition (Helykondíció)
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>]
VariableCondition
New-CMTSRule [-ReferencedVariableName <String>] [-ReferencedVariableOperator <VariableOperatorType>]
[-ReferencedVariableValue <String>] -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Ezzel a parancsmagtal létrehozhat egy szabályt, amely hozzáadható a Dinamikus változók beállítása feladatütemezési lépéshez. Amikor a feladatütemezés ezt a lépést futtatja, sorrendben értékeli ki a dinamikus szabályokat és változókat. Amikor kiértékeli az adott eszközön található szabályokat, feladatütemezési változókat állíthat be ezen szabályok alapján.
Négy szabálytípus létezik:
- Számítógép: Hardvereszköz-címke, UUID, sorozatszám vagy MAC-cím értékeinek kiértékelése.
- Hely: Értékelje ki az alapértelmezett hálózati átjáró értékeit.
- Make and Model (Make és Model): Értékelje ki a számítógép make (típus) és model (modell) értékeit.
- Feladatütemezési változó: Adjon hozzá egy feladatütemezési változót, feltételt és értéket az értékeléshez.
További információ: Dinamikus szabályok és változók.
Megjegyzés
Futtassa Konfigurációkezelő parancsmagokat a Konfigurációkezelő hely meghajtóról, például: PS XYZ:\>
. További információ: Első lépések.
EXAMPLES
1. példa: A letöltési célhely beállítása, ha Windows PE-ben
Ez a példa a következő szabályt hozza létre:
IF _SMSTSInWinPE equals "TRUE" THEN SET OSDDownloadDestinationLocationType = "TSCache"
Ezután hozzáadja ezt a szabályt a lépés egy meglévő példányához egy feladatütemezésben.
$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
Adjon meg egy Eszközcímkét a Számítógép szabálytípushoz. A maximális érték 255 karakter.
Ha például ezt az értéket értékre adja 123456
meg, az a következő szabályt adja hozzá: 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
Jóváhagyást kér a parancsmag futtatása előtt.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DefaultGateway
Adja meg az Alapértelmezett átjárót a Hely szabálytípushoz.
Ha például ezt az értéket értékre adja 192.168.10.1
meg, az a következő szabályt adja hozzá: 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
Ez a paraméter literál karakterértékekként kezeli a helyettesítő karaktereket. Nem kombinálhatja a ForceWildcardHandling használatával.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet (nem ajánlott). Nem kombinálhatja a DisableWildcardHandling használatával.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MacAddress
Adja meg a SZÁMÍTÓGÉP szabálytípus MAC-címét.
Ha például ezt az értéket értékre adja 00:11:22:33:44:55
meg, az a következő szabályt adja hozzá: 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 (Make)
Adja meg a Make (Make) és a Model (Modell) szabálytípust. A másik érték beállításhoz használja a Model paramétert. A szabály igaz értéket ad vissza, ha mindkét érték igaz.
Helyettesítő karaktereket is használhat:
*
: Több karakter?
: Egy karakter
Ha például ezt az értéket értékre, a Modell értékét értékre állítva Surface
a következő szabályt adja *
hozzá: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 (Modell)
Adja meg a Modell értéket a Make (Make) és a Model (Modell) szabálytípushoz. A másik érték beállításhoz használja a Make paramétert. A szabály igaz értéket ad vissza, ha mindkét érték igaz.
Helyettesítő karaktereket is használhat:
*
: Több karakter?
: Egy karakter
Ha például ezt az értéket értékre, a Make to értéket pedig értékre állítva *
a következő szabályt adja Surface
hozzá: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
Adja meg a változót a Feladatütemezési változó szabálytípushoz. Ehhez be kell állítania a ReferencedVariableOperator és a ReferencedVariableValue paramétereket is.
Ez a változónév lehet egy beépített feladatütemezési változó vagy egy ön által létrehozott egyéni változó. További információ: Feladatütemezési változók használata a Konfigurációkezelő.
Ha például a következő értékeket adja meg:
- ReferencedVariableName:
OSDRegisteredOrgName
- ReferencedVariableOperator:
Equals
- ReferencedVariableValue:
Contoso
Ezután hozzáadja a következő szabályt: 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
Adja meg a Feladatütemezési változó szabálytípus feltételét. Ehhez be kell állítania a ReferencedVariableName és a ReferencedVariableValue paramétereket is. Az elérhető operátorokért tekintse meg a paraméter elfogadott értékeinek listáját.
Ha például a következő értékeket adja meg:
- ReferencedVariableName:
OSDRegisteredOrgName
- ReferencedVariableOperator:
Equals
- ReferencedVariableValue:
Contoso
Ezután hozzáadja a következő szabályt: 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
Adja meg a Feladatütemezési változó szabálytípus értékét. Ehhez be kell állítania a ReferencedVariableName és a ReferencedVariableOperator paramétereket is.
Ha például a következő értékeket adja meg:
- ReferencedVariableName:
OSDRegisteredOrgName
- ReferencedVariableOperator:
Equals
- ReferencedVariableValue:
Contoso
Ezután hozzáadja a következő szabályt: 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 (Sorozatszám)
Adja meg a Számítógép szabálytípus sorozatszámát.
Ha például ezt az értéket értékre adja 123456
meg, az a következő szabályt adja hozzá: 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 (Uuid)
Adjon meg egy UUID-t a Számítógép szabálytípushoz.
Ha például ezt az értéket értékre adja de5ba380-f692-45e0-bbd3-0e40543b549e
meg, az a következő szabályt adja hozzá: 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 (Változó)
Adja meg azokat a meglévő vagy egyéni feladatütemezési változókat és társított értékeket, amelyek a lépésnél beállítva vannak, amikor a szabály kiértékelése true (igaz) lesz.
Ha például ezt az értéket értékre adja meg, az a szabály után a következő @{'OSDDownloadDestinationLocationType' = 'TSCache'}
THEN
változót adja hozzá: SET OSDDownloadDestinationLocationType = "TSCache"
Ha több változót is meg kell adni ugyanabban a kivonattáblában, használjon pontosvesszőt ( ;
) elválasztó karaktert. Például: @{'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
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Ez a parancsmag a következő általános paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction és -WarningVariable. További információ: about_CommonParameters.
INPUTS
None
OUTPUTS
IResultObject#SMS_TaskSequence_Rule
MEGJEGYZÉSEK
RELATED LINKS
Set-CMTSStepSetDynamicVariable
New-CMTSStepSetDynamicVariable