New-SCClassInstance
Adiciona uma instância de classe ao banco de dados.
Sintaxe
Default (Predefinição)
New-SCClassInstance
[-Class] <ManagementPackClass>
[-PassThru]
[-Property] <Hashtable>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet New-SCClassInstance adiciona uma instância de classe ao banco de dados.
Exemplos
Exemplo 1: Criar instâncias de classe de impressora
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."
}
}
Esses comandos criam um conjunto de 10 instâncias de classe de impressora chamadas Printer0 a Printer9. O local é definido como "Sede da Contoso" e todos eles estão associados ao Nome do Servidor "ContosoPrintServer".
Parâmetros
-Class
Especifica a classe na qual a nova instância se baseia. Você pode usar o cmdlet Get-SCClass para obter o objeto ManagementPackClass necessário para esse parâmetro.
Propriedades dos parâmetros
| Tipo: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ComputerName
Especifica um computador com o qual estabelecer uma conexão. O computador deve estar executando o serviço de Acesso a Dados do System Center. O valor padrão é o computador para a conexão atual do grupo de gerenciamento.
Os formatos válidos incluem um nome NetBIOS, um endereço IP ou um nome de domínio totalmente qualificado (FQDN). Para especificar o computador local, digite o nome do computador, "localhost" ou um ponto (.).
Propriedades dos parâmetros
| Tipo: | System.String[] |
| Default value: | Localhost |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Credential
Especifica uma conta de usuário sob a qual a conexão do grupo de gerenciamento será executada. A conta deve ter acesso ao servidor especificado no parâmetro ComputerName , se o servidor for especificado. O valor padrão é o usuário atual.
Você pode inserir um objeto PSCredential retornado pelo cmdlet Get-Credential .
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.PSCredential |
| Default value: | Current user context |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-PassThru
Especifica o objeto de saída que representa o novo objeto de instância de classe. Esse objeto de saída pode ser passado para outros cmdlets.
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Property
Uma hashtable de pares property-value que representam os valores de propriedade da nova instância. Cada chave da hashtable deve ser o nome de uma propriedade válida dentro da classe especificada no parâmetro Class e cada valor deve ser um objeto válido que pode ser armazenado na propriedade de sua chave correspondente.
Propriedades dos parâmetros
| Tipo: | System.Collections.Hashtable |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SCSession
Especifica uma conexão com um servidor de gerenciamento. O valor padrão é a conexão atual do grupo de gerenciamento.
Você pode inserir um objeto de conexão de grupo de gerenciamento retornado pelo Get-SCManagementGroupConnection cmdlet.
Propriedades dos parâmetros
| Tipo: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Você pode canalizar uma classe para o parâmetro Class do cmdlet New-SCClassInstance , por exemplo, o objeto retornado pelo cmdlet Get-SCClass .
Saídas
None
Este cmdlet não gera nenhuma saída.