Compartilhar via

New-SCSMClassInstance

  • Referência
Módulo:
System.Center.Service.Manager

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 chamada Printer0 até 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 do grupo de gerenciamento atual.

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 a 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 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

Um hashtable de pares property-value que representam os valores de propriedade da nova instância. Cada chave do hashtable deve ser o nome de uma propriedade válida dentro da classe especificada no parâmetro classe 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 do grupo de gerenciamento atual.

Você pode inserir um objeto de conexão de grupo de gerenciamento retornado pelo cmdlet Get-SCManagementGroupConnection.

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 redirecionar 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.