New-SCSMClassInstance
Aggiunge un'istanza della 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 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 della classe stampante denominate Printer0 tramite Printer9. La posizione è impostata su "Contoso Headquarters" e sono tutti associati al serverName "ContosoPrintServer".
Parametri
-Class
Specifica la classe su cui è basata la nuova istanza. È possibile usare il cmdlet Get-SCClass per ottenere l'oggetto ManagementPackClass necessario per questo parametro.
Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
Specifica un computer con cui stabilire una connessione. Nel computer deve essere in esecuzione il servizio System Center Data Access. Il valore predefinito è il computer per la connessione del gruppo di gestione corrente.
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 (.).
Type: | System.String[] |
Position: | Named |
Default value: | Localhost |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma dell'utente prima di eseguire il cmdlet.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Specifica un account utente con cui verrà eseguita la connessione al gruppo di gestione. L'account deve avere accesso al server specificato nel parametro ComputerName , se il server è specificato. L'impostazione predefinita è l'utente corrente.
È possibile immettere un oggetto PSCredential restituito dal cmdlet 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
Specifica l'oggetto di output che rappresenta il nuovo oggetto di istanza di classe. Questo oggetto di output può essere passato ad altri cmdlet.
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Property
Una hashtable 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.
Type: | System.Collections.Hashtable |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SCSession
Specifica una connessione a un server di gestione. Il valore predefinito è la connessione al gruppo di gestione corrente.
È possibile immettere un oggetto di connessione del Get-SCManagementGroupConnection
gruppo di gestione restituito dal cmdlet.
Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
È possibile inviare una pipe a 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.