Sdílet prostřednictvím


New-SCSMClassInstance

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

Syntax

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říd 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říd 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 ContosoPrintServer.

Parametry

-Class

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

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Určuje počítač, se kterým se má vytvořit připojení. Počítač musí být spuštěný ve službě 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). Pokud chcete zadat místní počítač, zadejte název počítače, "localhost" nebo tečku (.).

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:System.Management.Automation.SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 , který je vrácen rutinou Get-Credential .

Type:System.Management.Automation.PSCredential
Position:Named
Default value:Current user context
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Property

Hashtable párů vlastností-hodnota představující hodnoty vlastností nové instance. Každý klíč hashtable musí být název platné vlastnosti v rámci třídy, která je zadána v parametru Třídy a každá hodnota musí být platným objektem, který lze uložit ve vlastnosti odpovídajícího klíče.

Type:System.Collections.Hashtable
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 .

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

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

Výstupy

Tato rutina negeneruje žádný výstup.