New-CMTSStepJoinDomainWorkgroup

Ссылка

Модуль:: ConfigurationManager

Создайте шаг 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 сервера.