Partager via

New-SCSMClassInstance

  • Référence
Module:
System.Center.Service.Manager

Ajoute une instance de classe à la base de données.

Syntaxe

New-SCSMClassInstance
   [-Class] <ManagementPackClass>
   [-PassThru]
   [-Property] <Hashtable>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet New-SCSMClassInstance 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-SCSMClassInstance (Get-SCSMClass -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 Printer0 à Printer9. L’emplacement est défini sur « Siège de Contoso », et ils sont tous associés à l'ServerName « 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.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ComputerName

Spécifie un ordinateur avec lequel établir une connexion. L’ordinateur doit exécuter le service System Center Data Access. La valeur par défaut est l’ordinateur de la connexion de groupe d’administration actuelle.

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 (.).

Type:System.String[]
Position:Named
Valeur par défaut:Localhost
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:System.Management.Automation.SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 retourné par l’applet de commande Get-Credential .

Type:System.Management.Automation.PSCredential
Position:Named
Valeur par défaut:Current user context
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PassThru

Spécifie l’objet de sortie qui représente le nouvel objet d’instance de classe. Cet objet de sortie peut être passé à d’autres applets de commande.

Type:System.Management.Automation.SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 dans la classe spécifiée dans le paramètre Classe et chaque valeur doit être un objet valide qui peut être stocké dans la propriété de sa clé correspondante.

Type:System.Collections.Hashtable
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SCSession

Spécifie une connexion à un serveur d’administration. La valeur par défaut est la connexion de groupe d’administration actuelle.

Vous pouvez entrer un objet de connexion de groupe d’administration retourné par l’applet de commande Get-SCManagementGroupConnection.

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:System.Management.Automation.SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Vous pouvez diriger une classe vers le paramètre Class de l’applet de commande New-SCSMClassInstance, par exemple, l’objet retourné par l’applet de commande Get-SCClass .

Sorties

Cette applet de commande ne génère aucune sortie.