Compartilhar via

New-SCClassInstance

Módulo:
System.Center.Service.Manager Module

Adiciona uma instância de classe ao banco de dados.

Sintaxe

Default (Padrã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 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.

Propriedades do parâmetro

Tipo:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 (.).

Propriedades do parâmetro

Tipo:

System.String[]

Valor padrão:Localhost
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:System.Management.Automation.PSCredential
Valor padrão:Current user context
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:System.Collections.Hashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do grupo de gerenciamento retornado pelo Get-SCManagementGroupConnection cmdlet.

Propriedades do parâmetro

Tipo:

Microsoft.SystemCenter.Core.Connection.Connection[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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

Esse cmdlet não gera nenhuma saída.