Condividi tramite

New-SCSMClassInstance

  • Riferimento
Modulo:
System.Center.Service.Manager

Aggiunge un'istanza di classe al database.

Sintassi

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

Descrizione

Il cmdlet New-SCSMClassInstance aggiunge un'istanza di classe al database.

Esempio

Esempio 1: Creare istanze della classe della stampante

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

Questi comandi creano un set di 10 istanze di classe della stampante denominate Printer0 a Printer9. La posizione è impostata su "Contoso Headquarters" e sono tutti associati all'NomeServer "ContosoPrintServer".

Parametri

-Class

Specifica la classe su cui si basa la nuova istanza. È possibile usare il cmdlet Get-SCClass per ottenere l'oggetto ManagementPackClass necessario per questo parametro.

Tipo:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ComputerName

Specifica un computer con cui stabilire una connessione. Il computer deve eseguire il servizio di accesso ai dati di System Center. Il valore predefinito è il computer per la connessione al gruppo di gestione corrente.

I formati validi includono un nome NetBIOS, un indirizzo IP o un nome di dominio completo (FQDN). Per specificare il computer locale, digitare il nome del computer, "localhost" o un punto (.).

Tipo:System.String[]
Posizione:Named
Valore predefinito:Localhost
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:System.Management.Automation.SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Specifica un account utente in cui verrà eseguita la connessione al gruppo di gestione. L'account deve avere accesso al server specificato nel parametro NomeComputer, se il server è specificato. Il valore predefinito è l'utente corrente.

È possibile immettere un oggetto PSCredential restituito dal cmdlet Get-Credential .

Tipo:System.Management.Automation.PSCredential
Posizione:Named
Valore predefinito:Current user context
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Specifica l'oggetto di output che rappresenta il nuovo oggetto istanza della classe. Questo oggetto di output può essere passato ad altri cmdlet.

Tipo:System.Management.Automation.SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Property

Tabella hash di coppie proprietà-valore che rappresenta i valori delle proprietà della nuova istanza. Ogni chiave della tabella hash deve essere il nome di una proprietà valida all'interno della classe specificata nel parametro Class e ogni valore deve essere un oggetto valido che può essere archiviato nella proprietà della chiave corrispondente.

Tipo:System.Collections.Hashtable
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SCSession

Specifica una connessione a un server di gestione. Il valore predefinito è la connessione corrente al gruppo di gestione.

È possibile immettere un oggetto connessione del gruppo di gestione restituito dal cmdlet Get-SCManagementGroupConnection.

Tipo:Microsoft.SystemCenter.Core.Connection.Connection[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:System.Management.Automation.SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

È possibile inviare tramite pipe una classe al parametro class del cmdlet New-SCSMClassInstance, ad esempio l'oggetto restituito dal cmdlet Get-SCClass.

Output

Questo cmdlet non genera alcun output.