New-CMTSStepJoinDomainWorkgroup
Создайте шаг Join Domain или Workgroup, который можно добавить в последовательность задач.
Синтаксис
New-CMTSStepJoinDomainWorkgroup
[-DomainName <String>]
[-OU <String>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkgroupName <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
В этом комлете создается новый шаговой объект Join Domain или Workgroup. Затем используйте кодлет Add-CMTaskSequenceStep, чтобы добавить шаг в последовательность задач. Дополнительные сведения об этом шаге см. в статью О действиях последовательности задач: Join Domain или Workgroup.
Примечание
Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.
Примеры
Пример1
В этом примере сначала используется встроенный комлет ConvertTo-SecureString для создания безопасной строки для пароля пользователя. Этот метод используется здесь в качестве простого примера, но не самый безопасный, так как простой текстовый пароль находится в скрипте. Дополнительные сведения об этом и других параметрах см. в меню ConvertTo-SecureString.
Следующая строка создает объект для шага Join Domain или Workgroup с помощью переменной безопасного пароля строки.
Затем он получает объект последовательности задач и добавляет этот новый шаг в последовательность задач в индексе 11.
$Secure_String_Pwd = ConvertTo-SecureString "P@ssW0rD!" -AsPlainText -Force
$step = New-CMTSStepJoinDomainWorkgroup -Name "Join Domain or Workgroup" -DomainName "na.corp.contoso.com" -OU "LDAP://OU=Ops,OU=ITS,DC=na,DC=corp,DC=contoso,DC=com" -UserName "contoso\_cmosdjoin" -UserPassword $Secure_String_Pwd
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
Параметры
-Condition
Укажите объект условия, который можно использовать с помощью этого шага. Чтобы получить этот объект, используйте один из комлетов условий последовательности задач. Например, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Добавьте этот параметр, чтобы включить параметр Шаг Продолжить ошибку. Когда вы включаете этот параметр, если шаг не удается, последовательность задач продолжается.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Укажите необязательное описание для этого шага последовательности задач.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Этот параметр рассматривает символы под диктовки как буквальные значения символов. Вы не можете объединить его с ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainName
Чтобы настроить этот шаг, чтобы компьютер присоединился к домену, используйте этот параметр, чтобы указать имя домена, чтобы присоединиться. Затем используйте следующие параметры:
- DomainOU. Необязательно укажите организационное подразделение, в котором будет создаваться новая учетная запись компьютера.
- Имя пользователя. Укажите учетную запись пользователя с разрешениями присоединиться к компьютеру к домену.
- UserPassword. Укажите пароль для учетной записи пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Этот параметр обрабатывает символы под диктовки и может привести к неожиданному поведению (не рекомендуется). Вы не можете объединить его с DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Укажите имя для этого шага, чтобы идентифицировать его в последовательности задач.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OU
При использовании параметра DomainName можно также указать путь к организационному подразделению (OU). Когда компьютер присоединяется к домену, если он создает новую учетную запись компьютера, эта учетная запись будет в этом OU.
Пример: LDAP://OU=MyOu,DC=MyDom,DC=MyCompany,DC=com
Type: | String |
Aliases: | OrganizationalUnit |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserName
При использовании параметра DomainName используйте этот параметр для указания учетной записи пользователя домена, используемой для добавления компьютера назначения в домен. Чтобы указать пароль учетной записи, используйте параметр UserPassword.
Дополнительные сведения см. в записи присоединения домена последовательности задач.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPassword
Укажите пароль в качестве безопасной строки для параметра UserName.
Type: | SecureString |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Этот комдлет не работает.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkgroupName
Чтобы настроить этот шаг, чтобы компьютер присоединился к группе, используйте этот параметр, чтобы указать имя группы.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Отключение
Добавьте этот параметр, чтобы отключить этот шаг последовательности задач.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Нет
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см. в SMS_TaskSequence_JoinDomainWorkgroupAction класса WMI сервера.