Partilhar via


Update-SCClassInstance

Atualiza os valores de propriedade de uma instância de classe.

Sintaxe

Default (Predefinição)

Update-SCClassInstance
    [-Instance] <EnterpriseManagementInstance[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Update-SCClassInstance atualiza os valores de propriedade de uma instância de classe.

Exemplos

Exemplo 1: Marcar instâncias de classe para exclusão

PS C:\>Get-SCClassInstance (Get-SCClass -Name "System.Printer") | % { $_.ObjectStatus = "pending delete"; $_ } | Update-SCClassinstance

Este comando atualiza todas as instâncias de item de configuração da classe System.Printer para marcá-las para exclusão.

Exemplo 2: Alterar o valor do local de uma instância de item de configuração do Service Manager

PS C:\>Get-SCClassInstance -Class (Get-SCClass -Name "Microsoft.Ad.Printer") -Filter 'Location -eq "Seattle"' | Format-Table UNCName,PrinterName,Description,Location
UNCName                PrinterName Description Location
-------                ----------- ----------- --------
\\PrintServer\Printer4 Printer4                Seattle
\\PrintServer\Printer7 Printer7                Seattle
\\PrintServer\Printer1 Printer1                Seattle
\\PrintServer\Printer9 Printer9                Seattle
\\PrintServer\Printer6 Printer6                Seattle
\\PrintServer\Printer3 Printer3                Seattle
\\PrintServer\Printer2 Printer2                Seattle
\\PrintServer\Printer5 Printer5                Seattle
\\PrintServer\Printer0 Printer0                Seattle
\\PrintServer\Printer8 Printer8                Seattle


PS C:\>Get-SCClassInstance -Class (Get-SCClass -Name "Microsoft.Ad.Printer") -Filter 'Location -eq "Seattle"'| % { $_.Location = "Portland"; $_ } | Update-SCClassInstance
PS C:\>Get-SCClassInstance -Class (Get-SCClass -Name "Microsoft.Ad.Printer") -Filter 'Location -eq "Portland"' | Format-Table UNCName,PrinterName,Description,Location
UNCName                PrinterName Description Location
-------                ----------- ----------- --------
\\PrintServer\Printer4 Printer4                Portland
\\PrintServer\Printer7 Printer7                Portland
\\PrintServer\Printer1 Printer1                Portland
\\PrintServer\Printer9 Printer9                Portland
\\PrintServer\Printer6 Printer6                Portland
\\PrintServer\Printer3 Printer3                Portland
\\PrintServer\Printer2 Printer2                Portland
\\PrintServer\Printer5 Printer5                Portland
\\PrintServer\Printer0 Printer0                Portland
\\PrintServer\Printer8 Printer8                Portland

Esse comando altera o valor do local de uma instância de item de configuração do Service Manager.

Parâmetros

-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

-Instance

Especifica uma instância de uma classe a ser atualizada.

Propriedades dos parâmetros

Tipo:

Microsoft.EnterpriseManagement.Core.Cmdlets.Instances.EnterpriseManagementInstance[]

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

-PassThru

Indica que a instância de classe é retornada à sessão atual do Windows PowerShell após a conclusão da atualização. 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

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameterSystem.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.Core.Cmdlets.Instances.EnterpriseManagementInstance

Você pode canalizar uma instância de classe para o parâmetro Instance do cmdlet Update-SCClassInstance .

Saídas

EnterpriseManagementInstance

Este cmdlet gera um objeto EnterpriseManagementInstance quando o PassThru parâmetro é usado.