Поделиться через

New-CMTSStepJoinDomainWorkgroup

  • Ссылка
Модуль:
ConfigurationManager

Создайте шаг присоединения к домену или рабочей группе , который можно добавить в последовательность задач.

Синтаксис

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 , чтобы добавить шаг в последовательность задач. Дополнительные сведения об этом шаге см. в разделе Сведения о шагах последовательности задач: присоединение к домену или рабочей группе.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1

В этом примере сначала используется встроенный командлет ConvertTo-SecureString для создания безопасной строки для пароля пользователя. Этот метод используется здесь в качестве простого примера, но не самый безопасный, так как пароль в виде обычного текста находится в скрипте. Дополнительные сведения об этом командлете и других параметрах см. в разделе ConvertTo-SecureString.

В следующей строке создается объект для шага присоединение домена или рабочей группы с помощью переменной пароля безопасной строки.

Затем он получает объект последовательности задач и добавляет этот новый шаг в последовательность задач по индексу 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.

Тип:IResultObject[]
Aliases:Conditions
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ContinueOnError

Добавьте этот параметр, чтобы включить параметр шага Продолжить при ошибке. Если этот параметр включен, если шаг завершается ошибкой, последовательность задач продолжается.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Укажите необязательное описание для этого шага последовательности задач.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Disable

Добавьте этот параметр, чтобы отключить этот шаг последовательности задач.

Тип:SwitchParameter
Aliases:DisableThisStep
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DomainName

Чтобы настроить этот шаг для присоединения компьютера к домену, используйте этот параметр, чтобы указать имя домена для присоединения. Затем используйте следующие другие параметры:

  • DomainOU. При необходимости укажите подразделение, в котором будет создана учетная запись компьютера.
  • UserName. Укажите учетную запись пользователя с разрешениями на присоединение компьютера к домену.
  • UserPassword: укажите пароль для учетной записи пользователя.
Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Укажите имя для этого шага, чтобы определить его в последовательности задач.

Тип:String
Aliases:StepName
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OU

При использовании параметра DomainName можно также указать путь к подразделению. При присоединении компьютера к домену, если он создает новую учетную запись компьютера, эта учетная запись будет находиться в этом подразделении.

Пример: LDAP://OU=MyOu,DC=MyDom,DC=MyCompany,DC=com

Тип:String
Aliases:OrganizationalUnit
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UserName

При использовании параметра DomainName используйте этот параметр, чтобы указать учетную запись пользователя домена, которая используется для добавления целевого компьютера в домен. Используйте параметр UserPassword , чтобы указать пароль учетной записи.

Дополнительные сведения см. в статье Учетная запись присоединения к домену последовательности задач.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UserPassword

Укажите пароль в качестве безопасной строки для параметра UserName .

Тип:SecureString
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WorkgroupName

Чтобы настроить этот шаг для присоединения компьютера к рабочей группе, используйте этот параметр, чтобы указать имя рабочей группы.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_TaskSequence_JoinDomainWorkgroupAction класса WMI сервера.