Freigeben über


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.