New-SCClassInstance
Fügt der Datenbank eine Klasseninstanz hinzu.
Syntax
Default (Standardwert)
New-SCClassInstance
[-Class] <ManagementPackClass>
[-PassThru]
[-Property] <Hashtable>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Mit dem Cmdlet New-SCClassInstance wird der Datenbank eine Klasseninstanz hinzugefügt.
Beispiele
Beispiel 1: Erstellen von Druckerklasseninstanzen
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."
}
}
Mit diesen Befehlen wird ein Satz von 10 Druckerklasseninstanzen mit den Namen Printer0 bis Printer9 erstellt. Der Speicherort ist auf "Contoso Headquarters" festgelegt, und sie sind alle dem Servernamen "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.
Parametereigenschaften
| Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ComputerName
Gibt einen Computer an, mit dem eine Verbindung hergestellt werden soll. Auf dem Computer muss der System Center Data Access-Dienst ausgeführt werden. Der Standardwert ist der Computer für die aktuelle Verwaltungsgruppenverbindung.
Gültige Formate sind ein NetBIOS-Name, eine IP-Adresse oder ein vollqualifizierter Domänenname (Fully Qualified Domain Name, FQDN). Um den lokalen Computer anzugeben, geben Sie den Computernamen "localhost" oder einen Punkt (.) ein.
Parametereigenschaften
| Typ: | System.String[] |
| Standardwert: | Localhost |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Gibt ein Benutzerkonto an, unter dem die Verbindung mit der Verwaltungsgruppe ausgeführt wird. Das Konto muss Zugriff auf den Server haben, der im Parameter ComputerName 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.
Parametereigenschaften
| Typ: | System.Management.Automation.PSCredential |
| Standardwert: | Current user context |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PassThru
Gibt das Ausgabeobjekt an, das das neue Klasseninstanzobjekt darstellt. Dieses Ausgabeobjekt kann an andere Cmdlets übergeben werden.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Property
Eine Hashtabelle mit Eigenschafts-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 Parameter Class angegeben ist, und jeder Wert muss ein gültiges Objekt sein, das in der Eigenschaft des entsprechenden Schlüssels gespeichert werden kann.
Parametereigenschaften
| Typ: | System.Collections.Hashtable |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 2 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SCSession
Gibt eine Verbindung zu einem Management-Server an. Der Standardwert ist die aktuelle Verwaltungsgruppenverbindung.
Sie können ein Verbindungsobjekt für die Verwaltungsgruppe eingeben, das Get-SCManagementGroupConnection vom Cmdlet zurückgegeben wird.
Parametereigenschaften
| Typ: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Sie können eine Klasse über die Pipeline an den Class-Parameter des Cmdlets New-SCClassInstance übergeben, z. B. an das Objekt, das vom Cmdlet Get-SCClass zurückgegeben wird.
Ausgaben
None
Dieses Cmdlet generiert keine Ausgabe.