New-CMTSRule
SYNOPSIS
Maak een regel om toe te voegen aan een takenreeksstap Dynamische variabelen instellen.
SYNTAX
VariableOnly (standaard)
New-CMTSRule -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
ComputerCondition
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>]
VariableCondition
New-CMTSRule [-ReferencedVariableName <String>] [-ReferencedVariableOperator <VariableOperatorType>]
[-ReferencedVariableValue <String>] -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Gebruik deze cmdlet om een regel te maken die u kunt toevoegen aan een takenreeksstap Dynamische variabelen instellen. Wanneer de takenreeks deze stap wordt uitgevoerd, worden de dynamische regels en variabelen op volgorde geëvalueerd. Wanneer de regels op het specifieke apparaat worden geëvalueerd, kan het vervolgens takenreeksvariabelen instellen op basis van deze regels.
Er zijn vier typen regels:
- Computer: evalueer waarden voor hardware-assettag, UUID, serienummer of MAC-adres.
- Locatie: evalueer waarden voor de standaardnetwerkgateway.
- Merk en model: evalueer waarden voor het merk en model van een computer.
- Takenreeksvariabele: voeg een takenreeksvariabele, voorwaarde en waarde toe om te evalueren.
Zie Dynamische regels en variabelen voor meer informatie.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: de downloadbestemming instellen in Windows PE
In dit voorbeeld wordt de volgende regel gemaakt:
IF _SMSTSInWinPE equals "TRUE" THEN SET OSDDownloadDestinationLocationType = "TSCache"
Vervolgens wordt deze regel toegevoegd aan een bestaand exemplaar van deze stap in een takenreeks.
$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
Geef een assettag op voor het regeltype Computer. De maximumwaarde is 255 tekens.
Als u deze waarde bijvoorbeeld in stelt op 123456 , wordt de volgende regel toegevoegd: 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
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DefaultGateway
Geef de standaardgateway op voor het regeltype Locatie.
Als u deze waarde bijvoorbeeld in stelt op 192.168.10.1 , wordt de volgende regel toegevoegd: 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
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MacAddress
Geef het MAC-adres op voor het type computerregel.
Als u deze waarde bijvoorbeeld in stelt op 00:11:22:33:44:55 , wordt de volgende regel toegevoegd: 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
Geef het maken op voor het regeltype Maken en Model. Als u de andere waarde wilt instellen, gebruikt u de parameter Model. De regel evalueert true als beide waarden waar zijn.
U kunt jokertekens gebruiken:
*: Meerdere tekens?: Eén teken
Als u deze waarde bijvoorbeeld in stelt op Surface en model op , wordt de volgende * regel toegevoegd: 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
Geef het Model op voor het regeltype Maken en Model. Als u de andere waarde wilt instellen, gebruikt u de parameter Make. De regel evalueert true als beide waarden waar zijn.
U kunt jokertekens gebruiken:
*: Meerdere tekens?: Eén teken
Als u deze waarde bijvoorbeeld in stelt op * en Make op , wordt de volgende regel Surface toegevoegd: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
Geef de variabele op voor het regeltype Takenreeksvariabele. Hiervoor moet u ook de parameters ReferencedVariableOperator en ReferencedVariableValue instellen.
Deze variabelenaam kan een ingebouwde takenreeksvariabele zijn of een aangepaste variabele die u hebt gemaakt. Zie Takenreeksvariabelen gebruiken in Configuration Manager voor meer Configuration Manager.
Als u bijvoorbeeld de volgende waarden in stelt:
- Er wordt naar verwezenVariableName:
OSDRegisteredOrgName - Er wordt naar verwezenVariableOperator:
Equals - Er wordt naar verwezenVariableValue:
Contoso
Vervolgens wordt de volgende regel toegevoegd: 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
Geef de voorwaarde op voor het regeltype Takenreeksvariabele. Hiervoor moet u ook de parameters ReferencedVariableName en ReferencedVariableValue instellen. Zie de lijst met geaccepteerde waarden voor deze parameter voor de beschikbare operators.
Als u bijvoorbeeld de volgende waarden in stelt:
- Er wordt naar verwezenVariableName:
OSDRegisteredOrgName - Er wordt naar verwezenVariableOperator:
Equals - Er wordt naar verwezenVariableValue:
Contoso
Vervolgens wordt de volgende regel toegevoegd: 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
Geef de waarde op voor het regeltype Takenreeksvariabele. Hiervoor moet u ook de parameters ReferencedVariableName en ReferencedVariableOperator instellen.
Als u bijvoorbeeld de volgende waarden in stelt:
- Er wordt naar verwezenVariableName:
OSDRegisteredOrgName - Er wordt naar verwezenVariableOperator:
Equals - Er wordt naar verwezenVariableValue:
Contoso
Vervolgens wordt de volgende regel toegevoegd: 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
Geef een serienummer op voor het regeltype Computer.
Als u deze waarde bijvoorbeeld in stelt op 123456 , wordt de volgende regel toegevoegd: 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
Geef een UUID op voor het regeltype Computer.
Als u deze waarde bijvoorbeeld in stelt op de5ba380-f692-45e0-bbd3-0e40543b549e , wordt de volgende regel toegevoegd: 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
-Variabele
Geef de bestaande of aangepaste takenreeksvariabelen en bijbehorende waarden op die met de stap moeten worden ingesteld wanneer de regel als waar wordt geëvalueerd.
Als u deze waarde bijvoorbeeld in stelt op @{'OSDDownloadDestinationLocationType' = 'TSCache'} , wordt de volgende variabele toegevoegd na de van de THEN regel: SET OSDDownloadDestinationLocationType = "TSCache"
Als u meer dan één variabele in dezelfde hashtabel wilt opgeven, gebruikt u een punt-dubbele punt ( ; ) scheidingsteken. Bijvoorbeeld: @{'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
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.
INPUTS
Geen
OUTPUTS
IResultObject#SMS_TaskSequence_Rule
OPMERKINGEN
RELATED LINKS
Set-CMTSStepSetDynamicVariable
New-CMTSStepSetDynamicVariable