New-SCSMClassInstance
Adiciona uma instância de classe ao banco de dados.
Sintaxe
New-SCSMClassInstance
[-Class] <ManagementPackClass>
[-PassThru]
[-Property] <Hashtable>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O cmdlet New-SCSMClassInstance 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-SCSMClassInstance (Get-SCSMClass -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 ServerName "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.
| Tipo: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
| Cargo: | 1 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | 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 FQDN (nome de domínio totalmente qualificado). Para especificar o computador local, digite o nome do computador, "localhost" ou um ponto (.).
| Tipo: | System.String[] |
| Cargo: | Named |
| Valor padrão: | Localhost |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Tipo: | System.Management.Automation.SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Credential
Especifica uma conta de usuário na 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 que é retornado pelo cmdlet Get-Credential .
| Tipo: | System.Management.Automation.PSCredential |
| Cargo: | Named |
| Valor padrão: | Current user context |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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.
| Tipo: | System.Management.Automation.SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Property
Uma tabela de hash de pares de valor de propriedade que representam os valores de propriedade da nova instância. Cada chave da tabela de hash 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.
| Tipo: | System.Collections.Hashtable |
| Cargo: | 2 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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 do grupo de gerenciamento retornado pelo Get-SCManagementGroupConnection cmdlet.
| Tipo: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | System.Management.Automation.SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Você pode canalizar uma classe para o parâmetro Class do cmdlet New-SCSMClassInstance , por exemplo, o objeto retornado pelo cmdlet Get-SCClass .
Saídas
Esse cmdlet não gera nenhuma saída.