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.