New-SCClassInstance
Ajoute une instance de classe à la base de données.
Syntaxe
Default (Par défaut)
New-SCClassInstance
[-Class] <ManagementPackClass>
[-PassThru]
[-Property] <Hashtable>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande New-SCClassInstance ajoute une instance de classe à la base de données.
Exemples
Exemple 1 : Créer des instances de classe d’imprimante
PS C:\>0..9 | ForEach-Object {
New-SCClassInstance (Get-SCClass -Name "Microsoft.Ad.Printer") @{
UNCName = \\ContosoPrintServer\Printer$_
ServerName = "ContosoPrintServer"
PrinterName = "Printer$_"
Location = "Contoso Headquarters"
Notes = "Added by PowerShell script."
}
}
Ces commandes créent un ensemble de 10 instances de classe d’imprimante nommées Imprimante0 à Imprimante9. L’emplacement est défini sur « Siège social de Contoso » et ils sont tous associés au nom de serveur « ContosoPrintServer ».
Paramètres
-Class
Spécifie la classe sur laquelle la nouvelle instance est basée. Vous pouvez utiliser l’applet de commande Get-SCClass pour obtenir l’objet ManagementPackClass requis pour ce paramètre.
Propriétés du paramètre
| Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ComputerName
Spécifie un ordinateur avec lequel établir une connexion. L’ordinateur doit exécuter le service d’accès aux données System Center. La valeur par défaut est l’ordinateur pour la connexion actuelle du groupe d’administration.
Les formats valides incluent un nom NetBIOS, une adresse IP ou un nom de domaine complet (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, « localhost » ou un point (.).
Propriétés du paramètre
| Type: | System.String[] |
| Valeur par défaut: | Localhost |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Credential
Spécifie un compte d’utilisateur sous lequel la connexion au groupe d’administration s’exécutera. Le compte doit avoir accès au serveur spécifié dans le paramètre ComputerName , si le serveur est spécifié. La valeur par défaut est l’utilisateur actuel.
Vous pouvez entrer un objet PSCredential qui est renvoyé par l’applet de commande Get-Credential .
Propriétés du paramètre
| Type: | System.Management.Automation.PSCredential |
| Valeur par défaut: | Current user context |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PassThru
Spécifie l’objet de sortie qui représente le nouvel objet d’instance de classe. Cet objet de sortie peut être transmis à d’autres applets de commande.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Property
Table de hachage de paires propriété-valeur représentant les valeurs de propriété de la nouvelle instance. Chaque clé de la table de hachage doit être le nom d’une propriété valide au sein de la classe spécifiée dans le paramètre Class , et chaque valeur doit être un objet valide qui peut être stocké dans la propriété de sa clé correspondante.
Propriétés du paramètre
| Type: | System.Collections.Hashtable |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SCSession
Spécifie une connexion à un serveur de gestion. La valeur par défaut est la connexion actuelle du groupe d’administration.
Vous pouvez entrer un objet de connexion de groupe d’administration renvoyé par l’applet Get-SCManagementGroupConnection de commande.
Propriétés du paramètre
| Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Vous pouvez rediriger une classe vers le paramètre Class de l’applet de commande New-SCClassInstance , par exemple, l’objet renvoyé par l’applet de commande Get-SCClass .
Sorties
None
Cette applet de commande ne génère aucune sortie.