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

Diese Befehle erstellen einen Satz von 10 Druckerklasseninstanzen namens Printer0 bis Printer9. Der Speicherort ist auf "Contoso Headquarters" festgelegt, und sie sind alle dem ServerName "ContosoPrintServer" zugeordnet.

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.

Type:ManagementPackClass
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 (FQDN). Um den lokalen Computer anzugeben, geben Sie den Computernamen, „localhost“ oder einen Punkt (.) ein.

Type:String[]
Position:Named
Default value:Localhost
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSCredential
Position:Named
Default value:Current user context
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Property

Eine Hashtable von Eigenschaftswertpaaren, die die Eigenschaftenwerte der neuen Instanz darstellen. Jeder Schlüssel der Hashtable 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.

Type:Hashtable
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

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

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

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

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

Ausgaben

Dieses Cmdlet generiert keine Ausgabe.