Set-CimInstance

Set-CimInstance
    [-InputObject] <CimInstance>
    [-ComputerName <String[]>]
    [-ResourceUri <Uri>]
    [-OperationTimeoutSec <UInt32>]
    [-Property <IDictionary>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-CimInstance
    [-InputObject] <CimInstance>
    -CimSession <CimSession[]>
    [-ResourceUri <Uri>]
    [-OperationTimeoutSec <UInt32>]
    [-Property <IDictionary>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-CimInstance
    [-Query] <String>
    -CimSession <CimSession[]>
    -Property <IDictionary>
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-CimInstance
    [-Query] <String>
    -Property <IDictionary>
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Cette applet de commande est disponible uniquement sur la plateforme Windows.

Cette applet de commande modifie une instance CIM sur un serveur CIM.

Si le paramètre InputObject n’est pas spécifié, l’applet de commande fonctionne de l’une des manières suivantes :

• Si aucun paramètre ComputerName ni le paramètre CimSession n’est spécifié, cette applet de commande fonctionne sur WMI (Local Windows Management Instrumentation) à l’aide d’une session COM (Component Object Model).
• Si le paramètre ComputerName ou le paramètre CimSession est spécifié, cette applet de commande fonctionne sur le serveur CIM spécifié par le paramètre ComputerName ou le paramètre CimSession.

Si le paramètre InputObject est spécifié, l’applet de commande fonctionne de l’une des manières suivantes :

• Si ni le paramètre ComputerName ni le paramètre CimSession n’est spécifié, cette applet de commande utilise la session CIM ou le nom de l’ordinateur à partir de l’objet d’entrée.
• Si le paramètre ComputerName ou le paramètre CimSession est spécifié, alors cette applet de commande utilise la valeur du paramètre CimSession ou du paramètre ComputerName. Ce n’est pas très courant.

Cet exemple définit la valeur de la propriété VariableValue sur abcd à l’aide du paramètre Query. Vous pouvez modifier des instances correspondant à une requête WQL (Windows Management Instrumentation Query Language).

$instance = @ {
    Query = 'Select * from Win32_Environment where name LIKE "testvar%"'
    Property = @{VariableValue="abcd"}
}
Set-CimInstance @instance

Cet exemple récupère l'objet d'instance CIM, filtré par le paramètre de la requête , en utilisant l'applet de commande . La Set-CimInstance cmdlet modifie la valeur de la propriété VariableValue en abcd.

Get-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' |
  Set-CimInstance -Property @{VariableValue="abcd"}

$x = Get-CimInstance -Query 'Select * from Win32_Environment where Name="testvar"'
Set-CimInstance -InputObject $x -Property @{VariableValue="somevalue"} -PassThru

Cet exemple récupère les objets d’instance CIM filtrés par le paramètre Query dans une variable $x à l’aide de Get-CimInstance, puis transmet le contenu de la variable à l’applet de commande Set-CimInstance. Set-CimInstance modifie ensuite la propriété VariableValue en somevalue. Étant donné que le paramètre passThru est utilisé, cet exemple retourne un objet d’instance CIM modifié.

Cet exemple récupère l’objet d’instance CIM spécifié dans le paramètre Query dans une variable $x à l’aide de l’applet de commande Get-CimInstance et modifie la valeur de propriété VariableValue de l’objet à modifier. L’objet d’instance CIM est ensuite enregistré à l’aide de l’applet de commande Set-CimInstance. Étant donné que le paramètre passThru est utilisé, cet exemple retourne un objet d’instance CIM modifié.

$x = Get-CimInstance -Query 'Select * from Win32_Environment where name="testvar"'
$x.VariableValue = "Change"
Set-CimInstance -CimInstance $x -PassThru

Cet exemple utilise le paramètre commun WhatIf pour spécifier que la modification ne doit pas être effectuée, mais uniquement la sortie de ce qui se passerait si elle était effectuée.

$instance = @{
    Query = 'Select * from Win32_Environment where name LIKE "testvar%"'
    Property = @{VariableValue="abcd"}
    WhatIf = $true
}
Set-CimInstance @instance

Cet exemple utilise le paramètre commun Confirmer pour spécifier que la modification doit être effectuée uniquement après confirmation de l’utilisateur.

$instance = @{
    Query = 'Select * from Win32_Environment where name LIKE "testvar%"'
    Property = @{VariableValue="abcd"}
    Confirm = $true
}
Set-CimInstance @instance

Cet exemple crée une instance CIM avec les propriétés spécifiées à l’aide de l’applet de commande New-CimInstance et récupère son contenu dans une variable $x. La variable est ensuite transmise à la cmdlet Set-CimInstance, qui modifie la valeur de la propriété VariableValue en somevalue. Étant donné que le paramètre passThru est utilisé, cet exemple retourne un objet d’instance CIM modifié.

$instance = @{
    ClassName = 'Win32_Environment'
    Property = @{
        Name="testvar"
        UserName="domain\user"
    }
    Key = 'Name', 'UserName'
    ClientOnly = $true
}
$x = New-CimInstance @instance
Set-CimInstance -CimInstance $x -Property @{VariableValue="somevalue"} -PassThru

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Par défaut, cette applet de commande ne retourne aucune sortie.

Lorsque vous utilisez le paramètre passThru , cette applet de commande retourne l’objet d’instance CIM modifié.

PowerShell inclut les alias suivants pour Set-CimInstance:

• Windows :
  • scim

Cette applet de commande est disponible uniquement sur les plateformes Windows.