Sdílet prostřednictvím


New-SCSMClassInstance

Přidá instanci třídy do databáze.

Syntaxe

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

Description

Rutina New-SCSMClassInstance přidá instanci třídy do databáze.

Příklady

Příklad 1: Vytvoření instancí třídy tiskárny

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

Tyto příkazy vytvoří sadu 10 instancí třídy tiskárny s názvem Printer0 až Printer9. Umístění je nastavené na Contoso Headquarters a všechny jsou přidružené k názvu serveru server ContosoPrintServer.

Parametry

-Class

Určuje třídu, na které je nová instance založena. Pomocí rutiny Get-SCClass můžete získat objekt ManagementPackClass požadovaný pro tento parametr.

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ComputerName

Určuje počítač, se kterým se má navázat připojení. Na počítači musí být spuštěná služba System Center Data Access. Výchozí hodnota je počítač pro aktuální připojení skupiny pro správu.

Platné formáty zahrnují název NetBIOS, IP adresu nebo plně kvalifikovaný název domény (FQDN). Chcete-li zadat místní počítač, zadejte název počítače, "localhost" nebo tečku (.).

Typ:System.String[]
Position:Named
Default value:Localhost
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:System.Management.Automation.SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Určuje uživatelský účet, pod kterým se spustí připojení skupiny pro správu. Pokud je zadaný server, musí mít účet přístup k serveru zadanému v parametru ComputerName. Výchozí hodnota je aktuální uživatel.

Můžete zadat objekt PSCredential vrácený rutinou Get-Creden tial.

Typ:System.Management.Automation.PSCredential
Position:Named
Default value:Current user context
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

Určuje výstupní objekt, který představuje nový objekt instance třídy. Tento výstupní objekt lze předat jiným rutinám.

Typ:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Property

Hashtable of property-value pairs representing the property values of the new instance. Každý klíč hashtable musí být název platné vlastnosti v rámci třídy, která je zadána v parametru Class a každá hodnota musí být platným objektem, který může být uložen ve vlastnosti odpovídajícího klíče.

Typ:System.Collections.Hashtable
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SCSession

Určuje připojení k serveru pro správu. Výchozí hodnota je aktuální připojení skupiny pro správu.

Můžete zadat objekt připojení skupiny pro správu vrácený rutinou Get-SCManagementGroupConnection.

Typ:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:System.Management.Automation.SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Třídu můžete řadit do třídy parametru New-SCSMClassInstance, například objekt vrácený rutinou Get-SCClass.

Výstupy

Tato rutina negeneruje žádný výstup.