New-CMTSStepApplyWindowsSetting
Crie um passo Aplicar Definições do Windows , que pode adicionar a uma sequência de tarefas.
Sintaxe
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>]
Description
Este cmdlet cria um novo objeto de passo Aplicar Definições do Windows . Em seguida, utilize o cmdlet Add-CMTaskSequenceStep para adicionar o passo a uma sequência de tarefas. Para obter mais informações sobre este passo, consulte Acerca dos passos da sequência de tarefas: Aplicar Definições do Windows.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1
Este exemplo obtém primeiro um objeto de fuso horário. A linha seguinte cria um objeto para o passo Aplicar Definições do Windows que especifica várias definições específicas da localização. Em seguida, obtém um objeto de sequência de tarefas e adiciona este novo passo à sequência de tarefas no índice 11.
$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
Parâmetros
-Condition
Especifique um objeto de condição a utilizar com este passo. Para obter este objeto, utilize um dos cmdlets da condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.
Tipo: | IResultObject[] |
Aliases: | Conditions |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ContinueOnError
Adicione este parâmetro para ativar a opção de passo Continuar com o erro. Quando ativa esta opção, se o passo falhar, a sequência de tarefas continuará.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Description
Especifique uma descrição opcional para este passo de sequência de tarefas.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Disable
Adicione este parâmetro para desativar este passo de sequência de tarefas.
Tipo: | SwitchParameter |
Aliases: | DisableThisStep |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InputLocale
Utilize este parâmetro para definir a definição de região para o esquema de teclado predefinido. Por exemplo, para defini-lo como russo (Rússia), especifique a cadeia ru-ru: -InputLocale "ru-ru"
Para obter mais informações sobre estes valores de ficheiro de resposta de configuração do Windows, consulte Microsoft-Windows-International-Core.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Name
Especifique um nome para este passo para identificá-lo na sequência de tarefas.
Tipo: | String |
Aliases: | StepName |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-OrganizationName
Especifique o nome da organização registado a associar ao computador de destino.
Tipo: | String |
Aliases: | RegisteredOrganizationName |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Password
Para ativar a conta de Administrador local, utilize este parâmetro para especificar a palavra-passe. Se não incluir este parâmetro, a conta local está desativada por predefinição com uma palavra-passe gerada aleatoriamente.
Tipo: | SecureString |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ProductKey
Especifique a chave de produto a utilizar para a instalação do Windows no computador de destino.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SystemLocale
Utilize este parâmetro para definir a linguagem para programas não Unicode. Por exemplo, para defini-lo como russo (Rússia), especifique a cadeia ru-ru: -SystemLocale "ru-ru"
Para obter mais informações sobre estes valores de ficheiro de resposta de configuração do Windows, consulte Microsoft-Windows-International-Core.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-TimeZone
Especifique o fuso horário a configurar no computador de destino. Para obter este objeto, utilize o cmdlet incorporado Get-TimeZone .
Tipo: | TimeZoneInfo |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UILanguage
Utilize este parâmetro para definir o idioma da interface de utilizador (IU) predefinida do sistema. Por exemplo, para defini-lo como russo (Rússia), especifique a cadeia ru-ru: -UILanguage "ru-ru"
Para obter mais informações sobre estes valores de ficheiro de resposta de configuração do Windows, consulte Microsoft-Windows-International-Core.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UILanguageFallback
Utilize este parâmetro para definir a linguagem de contingência se a linguagem de IU predefinida do sistema estiver apenas parcialmente localizada. Por exemplo, para defini-lo como russo (Rússia), especifique a cadeia ru-ru: -UILanguageFallback "ru-ru"
Para obter mais informações sobre estes valores de ficheiro de resposta de configuração do Windows, consulte Microsoft-Windows-International-Core.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UserLocale
Utilize este parâmetro para definir as definições por utilizador utilizadas para formatar datas, horas, moeda e números. Por exemplo, para defini-lo como russo (Rússia), especifique a cadeia ru-ru: -UserLocale "ru-ru"
Para obter mais informações sobre estes valores de ficheiro de resposta de configuração do Windows, consulte Microsoft-Windows-International-Core.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UserName
Especifique o nome de utilizador registado a associar ao computador de destino.
Tipo: | String |
Aliases: | RegisteredUserName |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
None
Saídas
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_ApplyWindowsSettingsAction classe WMI de servidor.