Management
Cette section contient les rubriques d'aide pour les applets de commande installées avec le module PowerShell Microsoft.PowerShell.Management. Le module Management contient des applets de commande qui vous aident à gérer Windows dans PowerShell.
Add-Computer
Ajoutez l'ordinateur local à un domaine ou un groupe de travail.
Syntaxe
Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-UnjoinDomainCredential <PSCredential>]
[-Credential <PSCredential>]
[-DomainName] <String>
[-OUPath <String>]
[-Server <String>]
[-Unsecure]
[-Options <JoinOptions>]
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-Credential <PSCredential>]
[-WorkgroupName] <String>
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
La cmdlet Add-Computer
ajoute l'ordinateur local ou les ordinateurs distants à un domaine ou groupe de travail, ou les déplace d'un domaine à un autre. Elle crée également un compte de domaine si l'ordinateur est ajouté à un domaine sans compte.
Vous pouvez utiliser les paramètres de cette applet de commande pour spécifier une unité organisationnelle (OU) et un contrôleur de domaine ou pour effectuer une jointure non sécurisée.
Exemples
Exemple 1: Ajouter un ordinateur local à un domaine puis redémarrer l'ordinateur
Add-Computer -DomainName Domain01 -Restart
Cette commande ajoute l'ordinateur local au domaine Domain01
, puis redémarre l'ordinateur pour rendre le changement effectif.
Exemple 2: Ajouter un ordinateur local à un groupe de travail
Add-Computer -WorkgroupName WORKGROUP-A
Cette commande ajoute l'ordinateur local au groupe de travail WORKGROUP-A
.
Exemple 3: Ajouter un ordinateur local à un domaine
Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose
Cette commande ajoute l'ordinateur local au domaine Domain01
en utilisant le contrôleur de domaine Domain01\DC01
.
La commande utilise les paramètres PassThru
et Verbose
pour obtenir des informations détaillées sur le résultats de la commande.
Exemple 4: Ajouter un ordinateur local à un domaine en utilisant le paramètre OUPath
Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"
Cette commande ajoute l'ordinateur local au domaine Domain02
. Elle utilise le paramètre OUPath
pour spécifier l'unité organisationnelle pour les nouveaux comptes.
Exemple 5: Ajouter un ordinateur local à un domaine à l'aide d'informations d'identification
$addComputerSplat = @{
ComputerName = 'Server01'
LocalCredential = 'Server01\Admin01'
DomainName = 'Domain02'
Credential = 'Domain02\Admin02'
Restart = $true
Force = $true
}
Add-Computer @addComputerSplat
Cette commande ajoute l'ordinateur Server01
au domaine Domain02
. Elle utilise le paramètre LocalCredential
pour spécifier un compte d'utilisateur qui a l'autorisation de se connecter à l'ordinateur Server01
. Elle utilise le paramètre Credential
pour spécifier un compte d'utilisateur qui a l'autorisation de joindre des ordinateurs au domaine. Elle utilise le paramètre Restart
pour redémarrer l'ordinateur une fois l'opération de jointure terminée et le paramètre Force
pour supprimer les messages de confirmation de l'utilisateur.
Exemple 6: Déplacer un groupe d'ordinateurs vers un nouveau domaine
$addComputerSplat = @{
ComputerName = 'Server01', 'Server02', 'localhost'
DomainName = 'Domain02'
LocalCredential = 'Domain01\User01'
UnjoinDomainCredential = 'Domain01\Admin01'
Credential = 'Domain02\Admin01'
Restart = $true
}
Add-Computer @addComputerSplat
Cette commande déplace les ordinateurs Server01
et Server02
et l'ordinateur local de Domain01
à Domain02
.
Elle utilise le paramètre LocalCredential
pour spécifier un compte utilisateur autorisé à se connecter aux trois ordinateurs concernés. Elle utilise le paramètre UnjoinDomainCredential
pour spécifier un utilisateur compte qui a l'autorisation de dissocier les ordinateurs du domaine Domain01
et le paramètre Credential
pour spécifier un compte d'utilisateur qui a l'autorisation de joindre les ordinateurs au domaine Domain02
. Elle utilise le paramètre Restart
pour redémarrer les trois ordinateurs une fois le déplacement terminé.
Exemple 7: Déplacer un ordinateur vers un nouveau domaine et changer le nom de l'ordinateur
$addComputerSplat = @{
ComputerName = 'Server01'
DomainName = 'Domain02'
NewName = 'Server044'
Credential = 'Domain02\Admin01'
Restart = $true
}
Add-Computer @addComputerSplat
Cette commande déplace l'ordinateur Server01
vers le Domain02
et modifie le nom de l'ordinateur en Server044
.
La commande utilise les informations d'identification de l'utilisateur actuel pour se connecter à l'ordinateur Server01 et se déconnecter de son domaine actuel. Elle utilise le paramètre Credential
pour spécifier un compte utilisateur qui a la permission de joindre l'ordinateur au domaine Domain02
.
Exemple 8: Ajouter des ordinateurs répertoriés dans un fichier à un nouveau domaine
$addComputerSplat = @{
ComputerName = (Get-Content Servers.txt)
DomainName = 'Domain02'
Credential = 'Domain02\Admin02'
Options = 'Win9xUpgrade'
Restart = $true
}
Add-Computer @addComputerSplat
Cette commande ajoute les ordinateurs qui sont répertoriés dans le fichier Servers.txt
au domaine Domain02
. Elle utilise le paramètre Options
pour spécifier l'option Win9xUpgrade
. Le paramètre Restart
redémarre tous les ordinateurs nouvellement ajoutés une fois l'opération de jointure terminée.
Exemple 9 : Ajouter un ordinateur à un domaine avec un nouveau nom
L'utilisation de cette combinaison de commandes évite plusieurs redémarrages et plusieurs écritures dans Active Directory pour le même objet lorsque l'ordinateur joint le domaine avec le nouveau nom.
Rename-Computer -NewName "MyNewPC" -Force
$addComputerSplat = @{
DomainName = 'Contoso.com'
Credential = 'contoso\administrator'
Options = 'JoinWithNewName', 'AccountCreate'
}
Add-Computer @addComputerSplat
Paramètres
-ComputerName
Spécifie les ordinateurs à ajouter à un domaine ou groupe de travail. La valeur par défaut est l'ordinateur local.
Tapez le nom NetBIOS, une adresse Internet Protocol (IP) ou un nom de domaine complet pour chacun des ordinateurs distants. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur, un point (.
), ou "localhost
".
Ce paramètre ne repose pas sur la mise à distance de Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName
de Add-Computer
même si votre ordinateur n'est pas configuré pour exécuter des commandes à distance.
Ce paramètre est introduit dans Windows PowerShell 3.0.
-Confirm
Vous invite à confirmer avant d'exécuter l'applet de commande.
-Credential
Spécifie un compte d'utilisateur qui a l'autorisation de joindre les ordinateurs à un nouveau domaine. La valeur par défaut est l'utilisateur actuel.
Tapez un nom d'utilisateur, tel que "User01
" ou "Domain01\User01
", ou entrez un objet PSCrédentiel
, tels qu'un produit généré par l'applet Get-Credential
. Si vous tapez un nom d'utilisateur, vous serez invité à saisir un mot de passe.
Pour spécifier un compte d'utilisateur autorisé à supprimer l'ordinateur de son domaine actuel, utilisez le paramètre UnjoinDomainCredential
. Pour spécifier un compte d'utilisateur autorisé à se connecter sur un ordinateur distant, utilisez le paramètreLocalCredential
.
-DomainName
Spécifie le domaine auquel les ordinateurs sont ajoutés. Ce paramètre est requis lors de l'ajout de ordinateurs vers un domaine.
-Force
Supprime l'invite de confirmation de l'utilisateur. Sans ce paramètre, Add-Computer
vous oblige à confirmez l'ajout de chaque ordinateur.
Ce paramètre est introduit dans Windows PowerShell 3.0.
-LocalCredential
Spécifie un compte d'utilisateur qui a l'autorisation de se connecter aux ordinateurs spécifiés par le paramètre ComputerName
. La valeur par défaut est l'utilisateur actuel.
Tapez un nom d'utilisateur, tel que "User01
" ou "Domain01\User01
", ou entrez un objet PSCredential
, tels qu'un produit généré par l'applet Get-Credential
. Si vous tapez un nom d'utilisateur, vous serez invité à saisir un mot de passe.
Pour spécifier un compte d'utilisateur qui a l'autorisation d'ajouter les ordinateurs à un nouveau domaine, utilisez le paramètre Credential
. Pour spécifier un compte utilisateur autorisé à supprimer les ordinateurs leur domaine actuel, utilisez le paramètre UnjoinDomainCredential
.
Ce paramètre est introduit dans Windows PowerShell 3.0.
-NewName
Spécifie un nouveau nom pour l'ordinateur dans le nouveau domaine. Ce paramètre est valide uniquement lorsqu'un l'ordinateur est ajouté ou déplacé.
Ce paramètre est introduit dans Windows PowerShell 3.0.
-Options
Spécifie les options avancées pour Add-Computer
. Entrez une ou plusieurs valeurs dans une chaîne séparée par des virgules.
Les valeurs acceptables pour ce paramètre sont:
-
-
-
AccountCreate
: Crée un compte de domaine. La cmdletAdd-Computer
crée automatiquement un compte de domaine lorsqu'il ajoute un ordinateur à un domaine. Cette option est incluse pour être complète. -
Win9XUpgrade
: Indique que l'opération de jointure fait partie d'une mise à niveau du système d'exploitation Windows. -
UnsecuredJoin
: Effectue une jointure non sécurisée. Pour demander une jointure non sécurisée, utilisez le paramètreUnsecure
ou cette option. Si vous souhaitez passer un mot de passe machine, vous devez utiliser cette option dans combinaison avec l'optionPasswordPass
. -
PasswordPass
: Définit le mot de passe de la machine à la valeur du paramètreCredential
(DomaineCrédentiel) après avoir effectué une jointure non sécurisée. Cette option indique également que la valeur deCredential
(DomainCredential) est un mot de passe machine, pas un mot de passe utilisateur. Cette option est valable uniquement lorsque l'optionUnsecuredJoin
est spécifiée. Lorsque vous utilisez cette option, les informations d'identification fourni au paramètre-Credential
doit avoir un nom d'utilisateur nul. -
JoinWithNewName
: Renomme le nom de l'ordinateur dans le nouveau domaine au nom spécifié par le paramètreNewName.
Lorsque vous utilisez le paramètreNewName
, cette option est définie automatiquement. Ceci l'option est conçue pour être utilisée avec l'applet de commandeRename-Computer
. Si vous utilisez l'appletRename-Computer
pour renommer l'ordinateur, mais ne redémarrez pas l'ordinateur pour rendre la modification effective, vous pouvez utiliser ce paramètre pour joindre l'ordinateur à un domaine avec son nouveau nom. -
JoinReadOnly
: Utilise un compte de machine existant pour joindre l'ordinateur à un contrôleur de domaine en lecture seule. Le compte machine doit être ajouté à la liste autorisée pour la stratégie de réplication de mot de passe et le mot de passe du compte doit être répliqué sur le contrôleur de domaine en lecture seule avant l'opération de jointure. -
InstallInvoke : Définit les drapeaux
create
(0x2) etdelete
(0x4) du paramètreFJoinOptions
de la méthodeJoinDomainOrWorkgroup
.
-
-
Ce paramètre a été introduit dans Windows PowerShell 3.0.
-OUPath
Spécifie une unité organisationnelle (OU) pour le compte de domaine. Entrez le nom distinctif complet de l'OU entre guillemets. La valeur par défaut est l'OU par défaut pour les objets machine du domaine.
-PassThru
Renvoie un objet représentant l'élément avec lequel vous travaillez. Par défaut, cette cmdlet ne génère aucune sortie.
-Restart
Redémarre les ordinateurs ajoutés au domaine ou au groupe de travail. Un redémarrage est souvent nécessaire pour rendre le changement effectif.
Ce paramètre est introduit dans Windows PowerShell 3.0.
-Server
Spécifie le nom d'un contrôleur de domaine qui ajoute l'ordinateur au domaine. Entrez le nom au format DomainName\ComputerName
. Par défaut, aucun contrôleur de domaine n'est spécifié.
-UnjoinDomainCredential
Spécifie un compte d'utilisateur qui a l'autorisation de supprimer les ordinateurs de leurs domaines actuels. Le la valeur par défaut est l'utilisateur actuel.
Tapez un nom d'utilisateur, tel que "User01
" ou "Domain01\User01
", ou entrez un objet PSCrédentiel
, tels qu'un produit généré par l'applet Get-Credential
. Si vous tapez un nom d'utilisateur, vous serez invité à saisir un mot de passe.
Utilisez ce paramètre lorsque vous déplacez des ordinateurs vers un autre domaine. Pour spécifier un compte utilisateur qui a l'autorisation de rejoindre le nouveau domaine, utilisez le paramètre Credential.
Pour spécifier un compte d'utilisateur autorisé à se connecter à un ordinateur distant, utilisez le paramètre LocalCredential
.
Ce paramètre est introduit dans Windows PowerShell 3.0.
-Unsecure
Effectue une jointure non sécurisée au domaine spécifié.
-WhatIf
Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.
-WorkgroupName
Spécifie le nom d'un groupe de travail auquel les ordinateurs sont ajoutés. La valeur par défaut est "WORKGROUP
".
Rename-Computer
Renomme un ordinateur.
Syntaxe
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
La cmdlet Rename-Computer
renomme l'ordinateur local ou un ordinateur distant. Elle renomme un ordinateur à chaque commande.
Cette applet de commande a été introduite dans Windows PowerShell 3.0.
Exemples
Exemple 1: Renommer l'ordinateur local
Cette commande renomme l'ordinateur local en Server044
et redémarre pour appliquer le changement.
Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart
Exemple 2: Renommer un ordinateur distant
Cette commande renomme l'ordinateur Srv01
en Server001
. L'ordinateur n'est pas redémarré.
Le paramètre DomainCredential
spécifie les informations d'identification d'un utilisateur autorisé à renommer ordinateurs dans le domaine.
Le paramètre Force
supprime l'invite de confirmation.
Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force
Paramètres
-ComputerName
Renomme l'ordinateur distant spécifié. La valeur par défaut est l'ordinateur local.
Tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet d'un ordinateur distant. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur, un point (.
), ou localhost
.
Ce paramètre ne repose pas sur la télécommande PowerShell. Vous pouvez utiliser le ComputerName paramètre de Rename-Computer
même si votre ordinateur ne l'est pas configuré pour exécuter des commandes distantes.
-Confirm
Vous invite à confirmer avant d'exécuter l'applet de commande.
-DomainCredential
Spécifie un compte d'utilisateur qui a l'autorisation de se connecter au domaine. Des informations d'identification explicites sont nécessaires pour renommer un ordinateur joint à un domaine.
Saisissez un nom d'utilisateur, tel que User01
ou Domain01\User01
, ou entrez un PSCrédentiel objet, tel comme celui généré par le Get-Credential
applet.
Si vous tapez un nom d'utilisateur, cette applet de commande vous demande un mot de passe.
Pour spécifier un compte d'utilisateur qui a l'autorisation de se connecter à l'ordinateur spécifié par le ComputerName paramètre, utilisez le LocalCrédentiel paramètre.
-Force
Force la commande à s'exécuter sans demander la confirmation de l'utilisateur.
-LocalCredential
Spécifie un compte d'utilisateur qui a l'autorisation de se connecter à l'ordinateur spécifié par le ComputerName paramètre. La valeur par défaut est l'utilisateur actuel.
Saisissez un nom d'utilisateur, tel que User01
ou Domain01\User01
, ou entrez un PSCrédentiel objet, tels que un produit généré par le Get-Credential
applet.
Si vous tapez un nom d'utilisateur, cette applet de commande vous demande un mot de passe.
Pour spécifier un compte d'utilisateur autorisé à se connecter au domaine, utilisez le DomainCredential paramètre.
-NewName
Spécifie un nouveau nom pour l'ordinateur. Ce paramètre est requis.
Les noms standards peuvent contenir des lettres (a-z
(), (A-Z
), chiffres (0-9
), et tirets (-
), mais non espaces ou périodes (.
'). Le nom peut ne pas être entièrement composé de chiffres et ne pas être plus long que 63 Caractères
-PassThru
Renvoie les résultats de la commande. Sinon, cette applet de commande ne génère aucune sortie.
-Protocol
Spécifie le protocole à utiliser pour renommer l'ordinateur. Les valeurs acceptables pour ce paramètre sont: WSMan et DCOM. La valeur par défaut est DCOM.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
-Restart
Indique que cette applet de commande redémarre l'ordinateur qui a été renommé. Un redémarrage est souvent nécessaire pour rendre le changement efficace.
-WhatIf
Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.
-WsmanAuthentication
Spécifie le mécanisme utilisé pour authentifier les informations d'identification de l'utilisateur lorsque cette applet de commande utilise le WSMan protocole. Les valeurs acceptables pour ce paramètre sont:
-
-
- Basique
- CredSSP
- Défaut
- Digérer
- Kerberos
- Négocier
-
La valeur par défaut est Défaut.
Authentification Credential Security Service Provider (CredSSP), dans laquelle l'utilisateur les informations d'identification sont transmises à un ordinateur distant pour être authentifiées, est conçu pour les commandes qui exiger l'authentification sur plusieurs ressources, comme l'accès à un partage réseau distant. Ce mécanisme augmente le risque de sécurité de l'opération à distance. Si l'ordinateur distant est compromis, les informations d'identification qui lui sont transmises peuvent être utilisées pour contrôler > la session réseau.
Ce paramètre a été introduit dans Windows PowerShell 3.0.