New-CMTSStepJoinDomainWorkgroup
Crea un passaggio Aggiunta a un dominio o a un gruppo di lavoro, che puoi aggiungere a una sequenza di attività.
Sintassi
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>]
Descrizione
Questo cmdlet crea un nuovo oggetto passaggio Join Domain o Workgroup. Utilizzare quindi il cmdlet Add-CMTaskSequenceStep per aggiungere il passaggio a una sequenza di attività. Per ulteriori informazioni su questo passaggio, vedere About task sequence steps: Join Domain or Workgroup.
Nota
Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>
. Per ulteriori informazioni, vedere Introduzione.
Esempio
Esempio 1
In questo esempio viene innanzitutto utilizzato il cmdlet incorporato ConvertTo-SecureString per creare una stringa sicura per la password utente. Questo metodo viene utilizzato qui come esempio semplice, ma non il più sicuro poiché la password di testo normale è nello script. Per ulteriori informazioni su questo cmdlet e su altre opzioni, vedere ConvertTo-SecureString.
Nella riga successiva viene creato un oggetto per il passaggio Aggiunta a un dominio o a un gruppo di lavoro, utilizzando la variabile password stringa sicura.
Ottiene quindi un oggetto della sequenza di attività e aggiunge questo nuovo passaggio alla sequenza di attività in corrispondenza dell'indice 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
Parametri
-Condition
Specificare un oggetto condizione da utilizzare con questo passaggio. Per ottenere questo oggetto, utilizzare uno dei cmdlet delle condizioni della sequenza di attività. Ad esempio, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Aggiungere questo parametro per abilitare l'opzione del passaggio Continua in caso di errore. Quando abiliti questa opzione, se il passaggio ha esito negativo, la sequenza di attività continua.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Specificare una descrizione facoltativa per questo passaggio della sequenza di attività.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Aggiungi questo parametro per disabilitare questo passaggio della sequenza di attività.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainName
Per configurare questo passaggio in modo che il computer aderi a un dominio, utilizzare questo parametro per specificare il nome di un dominio da aggiungere. Utilizzare quindi gli altri parametri seguenti:
- DomainOU: Facoltativamente specificare un'unità organizzativa in cui creare il nuovo account computer.
- UserName: specificare l'account utente con le autorizzazioni per aggiungere un computer al dominio.
- UserPassword: specificare la password per l'account utente.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specificare un nome per questo passaggio per identificarlo nella sequenza di attività.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OU
Quando si utilizza il parametro DomainName, è anche possibile specificare il percorso di un'unità organizzativa. Quando il computer entra a far parte del dominio, se crea un nuovo account computer, tale account sarà in questa unità organizzativa.
Per esempio 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
Quando si utilizza il parametro DomainName, utilizzare questo parametro per specificare l'account utente di dominio utilizzato per aggiungere il computer di destinazione al dominio. Utilizzare il parametro UserPassword per specificare la password dell'account.
Per ulteriori informazioni, vedere l'account di aggiunta al dominio della sequenza di attività.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPassword
Specificare la password come stringa sicura per il parametro UserName.
Type: | SecureString |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkgroupName
Per configurare questo passaggio in modo che il computer si unirà a un gruppo di lavoro, utilizzare questo parametro per specificare il nome del gruppo di lavoro.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Nessuno
Output
IResultObject
Note
Per ulteriori informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_JoinDomainWorkgroupAction wmi del server.