New-CMTSStepJoinDomainWorkgroup
Crie uma etapa Ingressar domínio ou grupo de trabalho, que você pode adicionar a uma sequência de tarefas.
Syntax
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>]
Description
Este cmdlet cria um novo objeto de etapa Join Domain ou Workgroup. Em seguida, use o cmdlet Add-CMTaskSequenceStep para adicionar a etapa a uma sequência de tarefas. Para obter mais informações sobre esta etapa, consulte Sobre etapas de sequência de tarefas: Ingressar em Domínio ou Grupo de Trabalho.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\>
exemplo. Para obter mais informações, consulte getting started.
Exemplos
Exemplo 1
Este exemplo usa primeiro o cmdlet integrado ConvertTo-SecureString para criar uma cadeia de caracteres segura para a senha do usuário. Este método é usado aqui como um exemplo simples, mas não o mais seguro, já que a senha de texto sem texto está no script. Para obter mais informações sobre este cmdlet e outras opções, consulte ConvertTo-SecureString.
A próxima linha cria um objeto para a etapa Ingressar domínio ou grupo de trabalho, usando a variável de senha de cadeia de caracteres segura.
Em seguida, ele obtém um objeto de sequência de tarefas e adiciona essa nova etapa à sequência de tarefas no índice 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
Parâmetros
-Condition
Especifique um objeto condition a ser usado com esta etapa. Para obter esse objeto, use um dos cmdlets de condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Adicione esse parâmetro para habilitar a opção etapa Continuar no erro. Quando você habilita essa opção, se a etapa falhar, a sequência de tarefas continuará.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifique uma descrição opcional para esta etapa de sequência de tarefas.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Adicione esse parâmetro para desabilitar essa etapa de sequência de tarefas.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainName
Para configurar essa etapa para que o computador institua um domínio, use esse parâmetro para especificar o nome de um domínio a ser instituido. Em seguida, use os seguintes outros parâmetros:
- DomainOU: Opcionalmente, especifique uma unidade organizacional na qual criar a nova conta do computador.
- UserName: Especifique a conta de usuário com permissões para ingressar um computador no domínio.
- UserPassword: especifique a senha da conta de usuário.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique um nome para esta etapa para identificá-lo na sequência de tarefas.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OU
Ao usar o parâmetro DomainName, você também pode especificar o caminho para uma unidade organizacional (OU). Quando o computador ingressar no domínio, se ele criar uma nova conta de computador, essa conta estará nessa OU.
Por exemplo, 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
Ao usar o parâmetro DomainName, use esse parâmetro para especificar a conta de usuário de domínio usada para adicionar o computador de destino ao domínio. Use o parâmetro UserPassword para especificar a senha da conta.
Para obter mais informações, consulte a conta de junção de domínio dasequência de tarefas .
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPassword
Especifique a senha como uma cadeia de caracteres segura para o parâmetro UserName.
Type: | SecureString |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkgroupName
Para configurar essa etapa para que o computador institua um grupo de trabalho, use esse parâmetro para especificar o nome do grupo de trabalho.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Nenhum
Saídas
IResultObject
Observações
Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_TaskSequence_JoinDomainWorkgroupAction classe WMI do servidor.