Freigeben über


New-SCSMClassInstance

Fügt der Datenbank eine Klasseninstanz hinzu.

Syntax

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

Beschreibung

Das Cmdlet New-SCSMClassInstance fügt der Datenbank eine Klasseninstanz hinzu.

Beispiele

Beispiel 1: Erstellen von Druckerklasseninstanzen

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." 
  }
}

Mit diesen Befehlen wird eine Reihe von 10 Druckerklasseninstanzen namens "Printer0" bis "Printer9" erstellt. Der Speicherort ist auf "Contoso Headquarters" festgelegt, und sie sind alle mit dem ServerName "ContosoPrintServer" verknüpft.

Parameter

-Class

Gibt die Klasse an, auf der die neue Instanz basiert. Sie können das Cmdlet Get-SCClass verwenden, um das ManagementPackClass--Objekt abzurufen, das für diesen Parameter erforderlich ist.

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ComputerName

Gibt einen Computer an, mit dem eine Verbindung hergestellt werden soll. Der Computer muss den System Center Data Access-Dienst ausführen. Der Standardwert ist der Computer für die aktuelle Verwaltungsgruppenverbindung.

Gültige Formate umfassen einen NetBIOS-Namen, eine IP-Adresse oder einen vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN). Geben Sie zum Angeben des lokalen Computers den Computernamen "localhost" oder einen Punkt (.) ein.

Typ:System.String[]
Position:Named
Standardwert:Localhost
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:System.Management.Automation.SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt ein Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Das Konto muss Zugriff auf den Server haben, der im ComputerName Parameter angegeben ist, wenn der Server angegeben ist. Der Standardwert ist der aktuelle Benutzer.

Sie können ein PSCredential--Objekt eingeben, das vom Cmdlet Get-Credential zurückgegeben wird.

Typ:System.Management.Automation.PSCredential
Position:Named
Standardwert:Current user context
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt das Ausgabeobjekt an, das das neue Klasseninstanzobjekt darstellt. Dieses Ausgabeobjekt kann an andere Cmdlets übergeben werden.

Typ:System.Management.Automation.SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Property

Eine Hashtabelle von Eigenschaft-Wert-Paaren, die die Eigenschaftswerte der neuen Instanz darstellen. Jeder Schlüssel der Hashtabelle muss der Name einer gültigen Eigenschaft innerhalb der Klasse sein, die im Class-Parameter angegeben ist, und jeder Wert muss ein gültiges Objekt sein, das in der Eigenschaft des entsprechenden Schlüssels gespeichert werden kann.

Typ:System.Collections.Hashtable
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SCSession

Gibt eine Verbindung mit einem Verwaltungsserver an. Der Standardwert ist die aktuelle Verwaltungsgruppenverbindung.

Sie können ein Verwaltungsgruppenverbindungsobjekt eingeben, das vom Cmdlet Get-SCManagementGroupConnection zurückgegeben wird.

Typ:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:System.Management.Automation.SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Sie können eine Klasse an den parameter Class des Cmdlets New-SCSMClassInstance weiterleiten, z. B. das Objekt, das vom cmdlet Get-SCClass zurückgegeben wird.

Ausgaben

Dieses Cmdlet generiert keine Ausgabe.