New-SCSMClassInstance
Agrega una instancia de clase a la base de datos.
Sintaxis
New-SCSMClassInstance
[-Class] <ManagementPackClass>
[-PassThru]
[-Property] <Hashtable>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet New-SCSMClassInstance agrega una instancia de clase a la base de datos.
Ejemplos
Ejemplo 1: Creación de instancias de clase de impresora
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."
}
}
Estos comandos crean un conjunto de 10 instancias de clase de impresora denominadas Printer0 a Printer9. La ubicación se establece en "Contoso Headquarters" y todos están asociados con el ServerName "ContosoPrintServer".
Parámetros
-Class
Especifica la clase en la que se basa la nueva instancia. Puede usar el cmdlet Get-SCClass para obtener el objeto ManagementPackClass necesario para este parámetro.
Tipo: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-ComputerName
Especifica un equipo con el que se va a establecer una conexión. El equipo debe ejecutar el servicio de acceso a datos de System Center. El valor predeterminado es el equipo para la conexión actual del grupo de administración.
Los formatos válidos incluyen un nombre NetBIOS, una dirección IP o un nombre de dominio completo (FQDN). Para especificar el equipo local, escriba el nombre del equipo, "localhost" o un punto (.).
Tipo: | System.String[] |
Posición: | Named |
Valor predeterminado: | Localhost |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Tipo: | System.Management.Automation.SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Credential
Especifica una cuenta de usuario en la que se ejecutará la conexión del grupo de administración. La cuenta debe tener acceso al servidor especificado en el parámetro ComputerName , si se especifica el servidor. El valor predeterminado es el usuario actual.
Puede escribir un objeto PSCredential devuelto por el cmdlet Get-Credential .
Tipo: | System.Management.Automation.PSCredential |
Posición: | Named |
Valor predeterminado: | Current user context |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PassThru
Especifica el objeto de salida que representa el objeto de instancia de la nueva clase. Este objeto de salida se puede pasar a otros cmdlets.
Tipo: | System.Management.Automation.SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Property
Tabla hash de pares propiedad-valor que representan los valores de propiedad de la nueva instancia. Cada clave de la tabla hash debe ser el nombre de una propiedad válida dentro de la clase que se especifica en el parámetro Class y cada valor debe ser un objeto válido que se pueda almacenar en la propiedad de su clave correspondiente.
Tipo: | System.Collections.Hashtable |
Posición: | 2 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SCSession
Especifica una conexión a un servidor de administración. El valor predeterminado es la conexión actual del grupo de administración.
Puede escribir un objeto de conexión de grupo de administración devuelto por el Get-SCManagementGroupConnection
cmdlet.
Tipo: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Tipo: | System.Management.Automation.SwitchParameter |
Alias: | wi |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Entradas
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Puede canalizar una clase al parámetro Class del cmdlet New-SCSMClassInstance , por ejemplo, el objeto devuelto por el cmdlet Get-SCClass .
Salidas
Este cmdlet no genera ningún resultado.