New-CMTSStepApplyWindowsSetting
Erstellen Sie einen Schritt Windows-Einstellungen anwenden , den Sie einer Tasksequenz hinzufügen können.
Syntax
New-CMTSStepApplyWindowsSetting
[-InputLocale <String>]
-OrganizationName <String>
[-Password <SecureString>]
[-ProductKey <String>]
[-SystemLocale <String>]
[-TimeZone <TimeZoneInfo>]
[-UILanguage <String>]
[-UILanguageFallback <String>]
[-UserLocale <String>]
-UserName <String>
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet erstellt ein neues Schrittobjekt "Windows-Einstellungen anwenden ". Verwenden Sie dann das Cmdlet Add-CMTaskSequenceStep , um den Schritt einer Tasksequenz hinzuzufügen. Weitere Informationen zu diesem Schritt finden Sie unter Informationen zu Tasksequenzschritten: Anwenden von Windows-Einstellungen.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>
. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1
In diesem Beispiel wird zunächst ein Zeitzonenobjekt abgerufen. In der nächsten Zeile wird ein -Objekt für den Schritt Windows-Einstellungen anwenden erstellt, das verschiedene standortspezifische Einstellungen angibt. Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz am Index 11 hinzu.
$tz = Get-TimeZone -Id "Russian Standard Time"
$step = New-CMTSStepApplyWindowsSetting -Name "Apply Windows Settings for Moscow office" -UserName "Natalia Ivanovna" -OrganizationName "Contoso" -TimeZone $tz -InputLocale "ru-ru" -SystemLocale "ru-ru" -UILanguage "ru-ru" UserLocale "ru-ru"
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
Parameter
-Condition
Geben Sie ein Bedingungsobjekt an, das mit diesem Schritt verwendet werden soll. Verwenden Sie zum Abrufen dieses Objekts eines der Tasksequenzbedingungs-Cmdlets. Beispiel: Get-CMTSStepConditionVariable.
Typ: | IResultObject[] |
Aliase: | Conditions |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ContinueOnError
Fügen Sie diesen Parameter hinzu, um die Schrittoption Bei Fehler fortsetzen zu aktivieren. Wenn Sie diese Option aktivieren und der Schritt fehlschlägt, wird die Tasksequenz fortgesetzt.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Description
Geben Sie eine optionale Beschreibung für diesen Tasksequenzschritt an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Disable
Fügen Sie diesen Parameter hinzu, um diesen Tasksequenzschritt zu deaktivieren.
Typ: | SwitchParameter |
Aliase: | DisableThisStep |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-InputLocale
Verwenden Sie diesen Parameter, um die Gebietsschemaeinstellung für das Standardtastataturlayout festzulegen. Um sie beispielsweise auf Russisch (Russland) festzulegen, geben Sie die Zeichenfolge ru-ru an: -InputLocale "ru-ru"
Weitere Informationen zu diesen Werten der Windows-Setup-Antwortdatei finden Sie unter Microsoft-Windows-International-Core.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie einen Namen für diesen Schritt an, um ihn in der Tasksequenz zu identifizieren.
Typ: | String |
Aliase: | StepName |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-OrganizationName
Geben Sie den registrierten Organisationsnamen an, der dem Zielcomputer zugeordnet werden soll.
Typ: | String |
Aliase: | RegisteredOrganizationName |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Password
Verwenden Sie diesen Parameter, um das lokale Administratorkonto zu aktivieren, um das zugehörige Kennwort anzugeben. Wenn Sie diesen Parameter nicht einschließen, wird das lokale Konto standardmäßig mit einem zufällig generierten Kennwort deaktiviert.
Typ: | SecureString |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ProductKey
Geben Sie den Product Key an, der für die Windows-Installation auf dem Zielcomputer verwendet werden soll.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SystemLocale
Verwenden Sie diesen Parameter, um die Sprache für Nicht-Unicode-Programme festzulegen. Um sie beispielsweise auf Russisch (Russland) festzulegen, geben Sie die Zeichenfolge ru-ru an: -SystemLocale "ru-ru"
Weitere Informationen zu diesen Werten der Windows-Setup-Antwortdatei finden Sie unter Microsoft-Windows-International-Core.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-TimeZone
Geben Sie die Zeitzone an, die auf dem Zielcomputer konfiguriert werden soll. Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet Get-TimeZone .
Typ: | TimeZoneInfo |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UILanguage
Verwenden Sie diesen Parameter, um die Standardsprache der Benutzeroberfläche des Systems festzulegen. Um sie beispielsweise auf Russisch (Russland) festzulegen, geben Sie die Zeichenfolge ru-ru an: -UILanguage "ru-ru"
Weitere Informationen zu diesen Werten der Windows-Setup-Antwortdatei finden Sie unter Microsoft-Windows-International-Core.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UILanguageFallback
Verwenden Sie diesen Parameter, um die Fallbacksprache festzulegen, wenn die Standardsprache der Benutzeroberfläche des Systems nur teilweise lokalisiert ist. Um sie beispielsweise auf Russisch (Russland) festzulegen, geben Sie die Zeichenfolge ru-ru an: -UILanguageFallback "ru-ru"
Weitere Informationen zu diesen Werten der Windows-Setup-Antwortdatei finden Sie unter Microsoft-Windows-International-Core.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UserLocale
Verwenden Sie diesen Parameter, um die Benutzereinstellungen festzulegen, die zum Formatieren von Datumsangaben, Uhrzeiten, Währungen und Zahlen verwendet werden. Um sie beispielsweise auf Russisch (Russland) festzulegen, geben Sie die Zeichenfolge ru-ru an: -UserLocale "ru-ru"
Weitere Informationen zu diesen Werten der Windows-Setup-Antwortdatei finden Sie unter Microsoft-Windows-International-Core.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UserName
Geben Sie den registrierten Benutzernamen an, der dem Zielcomputer zugeordnet werden soll.
Typ: | String |
Aliase: | RegisteredUserName |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_ApplyWindowsSettingsAction WMI-Serverklasse.