New-CMTSRule

  • Artikel

SYNOPSIS

Skapa en regel som ska läggas till i aktivitetssekvenssteget Ange dynamiska variabler.

SYNTAX

VariableOnly (standard)

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

Använd den här cmdleten för att skapa en regel som du kan lägga till i aktivitetssekvenssteget Ange dynamiska variabler. När aktivitetssekvensen kör det här steget utvärderas de dynamiska reglerna och variablerna i ordning. När den utvärderar reglerna på den specifika enheten kan den sedan ange aktivitetssekvensvariabler baserat på dessa regler.

Det finns fyra typer av regler:

  • Dator: Utvärdera värden för maskinvarutillgångstagg, UUID, serienummer eller MAC-adress.
  • Plats: Utvärdera värden för standardnätverksgatewayen.
  • Modell och modell: Utvärdera värden för en dators modell och modell.
  • Aktivitetssekvensvariabel: Lägg till en aktivitetssekvensvariabel, ett villkor och ett värde som ska utvärderas.

Mer information finns i Dynamiska regler och variabler.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Ange nedladdningsmålet i Windows PE

I det här exemplet skapas följande regel:

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

Den lägger sedan till den här regeln till en befintlig instans av det här steget i en aktivitetssekvens.

$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

Ange en tillgångstagg för regeltypen Dator. Det maximala värdet är 255 tecken.

Om du till exempel anger det här värdet 123456 till lägger den till följande regel: 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

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-DefaultGateway

Ange standardgatewayen för regeltypen Plats.

Om du till exempel anger det här värdet 192.168.10.1 till lägger den till följande regel: 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

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-MacAddress

Ange MAC-adressen för datorregeltypen.

Om du till exempel anger det här värdet 00:11:22:33:44:55 till lägger den till följande regel: 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

-Skapa

Ange Make (Skapa) för regeltypen Make (Skapa) och Model (Modell). Om du vill ange det andra värdet använder du parametern Modell. Regeln utvärderar sant när båda värdena är sanna.

Du kan använda jokertecken:

  • *: Flera tecken
  • ?: Enskilt tecken

Om du till exempel anger det här värdet till Surface och Modell till lägger den till * följande regel: 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

-Modell

Ange modell för regeltypen Modell och Modell. Ange det andra värdet med hjälp av parametern Make. Regeln utvärderar sant när båda värdena är sanna.

Du kan använda jokertecken:

  • *: Flera tecken
  • ?: Enskilt tecken

Om du till exempel anger det här värdet till och Gör till läggs följande regel * Surface till: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

Ange variabeln för regeltypen Aktivitetssekvensvariabel. Du måste också ange parametrarna ReferencedVariableOperator och ReferencedVariableValue.

Det här variabelnamnet kan vara en inbyggd aktivitetssekvensvariabel eller en anpassad variabel som du har skapat. Mer information finns i Använda aktivitetssekvensvariabler i Konfigurationshanteraren.

Om du till exempel anger följande värden:

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

Sedan läggs följande regel till: 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

Ange villkor för regeltypen Aktivitetssekvensvariabel. Du måste också ange parametrarna ReferencedVariableName och ReferencedVariableValue. Tillgängliga operatorer finns i listan över godkända värden för den här parametern.

Om du till exempel anger följande värden:

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

Sedan läggs följande regel till: 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

Ange värdet för regeltypen Aktivitetssekvensvariabel. Du måste också ange parametrarna ReferencedVariableName och ReferencedVariableOperator.

Om du till exempel anger följande värden:

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

Sedan läggs följande regel till: 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

Ange ett serienummer för regeltypen Dator.

Om du till exempel anger det här värdet 123456 till lägger den till följande regel: 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

Ange ett UUID för regeltypen Dator.

Om du till exempel anger det här värdet de5ba380-f692-45e0-bbd3-0e40543b549e till lägger den till följande regel: 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

-Variabel

Ange befintliga eller anpassade aktivitetssekvensvariabler och associerade värden som steget ska ange när regeln utvärderas till true.

Om du till exempel anger det här värdet @{'OSDDownloadDestinationLocationType' = 'TSCache'} till lägger den till följande variabel efter för THEN regeln: SET OSDDownloadDestinationLocationType = "TSCache"

Om du vill ange fler än en variabel i samma hash-tabell använder du avgränsaren semikolon ( ; ). Exempelvis: @{'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

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Ingen

OUTPUTS

IResultObject#SMS_TaskSequence_Rule

ANTECKNINGAR

Set-CMTSStepSetDynamicVariable

New-CMTSStepSetDynamicVariable

Om aktivitetssekvenssteg – Ange dynamiska variabler

Använda aktivitetssekvensvariabler i Konfigurationshanteraren