New-SCClassInstance
Agrega una instancia de clase a la base de datos.
Sintaxis
Default (Es el valor predeterminado).
New-SCClassInstance
[-Class] <ManagementPackClass>
[-PassThru]
[-Property] <Hashtable>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet New-SCClassInstance 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-SCClassInstance (Get-SCClass -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.
Propiedades del parámetro
| Tipo: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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 (.).
Propiedades del parámetro
| Tipo: | System.String[] |
| Valor predeterminado: | Localhost |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades del parámetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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 .
Propiedades del parámetro
| Tipo: | System.Management.Automation.PSCredential |
| Valor predeterminado: | Current user context |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | System.Collections.Hashtable |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 2 |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades del parámetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Puede canalizar una clase al parámetro Class del cmdlet New-SCClassInstance , por ejemplo, el objeto devuelto por el cmdlet Get-SCClass .
Salidas
None
Este cmdlet no genera ninguna salida.