New-SCSMClassInstance
Přidá instanci třídy do databáze.
Syntax
New-SCSMClassInstance
[-Class] <ManagementPackClass>
[-PassThru]
[-Property] <Hashtable>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina New-SCSMClassInstance přidá instanci třídy do databáze.
Příklady
Příklad 1: Vytvoření instancí tříd tiskárny
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."
}
}
Tyto příkazy vytvoří sadu 10 instancí tříd tiskárny s názvem Printer0 až Printer9. Umístění je nastavené na "Contoso Headquarters" a všechny jsou přidružené k názvu serveru ContosoPrintServer.
Parametry
-Class
Určuje třídu, na které je nová instance založena. Pomocí rutiny Get-SCClass můžete získat objekt ManagementPackClass , který je pro tento parametr vyžadován.
Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
Určuje počítač, se kterým se má vytvořit připojení. Počítač musí být spuštěný ve službě System Center Data Access. Výchozí hodnota je počítač pro aktuální připojení skupiny pro správu.
Platné formáty zahrnují název netBIOS, IP adresu nebo plně kvalifikovaný název domény (FQDN). Pokud chcete zadat místní počítač, zadejte název počítače, "localhost" nebo tečku (.).
Type: | System.String[] |
Position: | Named |
Default value: | Localhost |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Určuje uživatelský účet, pod kterým se spustí připojení skupiny pro správu. Pokud je zadaný server, musí mít účet přístup k serveru zadanému v parametru ComputerName . Výchozí hodnota je aktuální uživatel.
Můžete zadat objekt PSCredential , který je vrácen rutinou Get-Credential .
Type: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | Current user context |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Určuje výstupní objekt, který představuje nový objekt instance třídy. Tento výstupní objekt lze předat jiným rutinám.
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Property
Hashtable párů vlastností-hodnota představující hodnoty vlastností nové instance. Každý klíč hashtable musí být název platné vlastnosti v rámci třídy, která je zadána v parametru Třídy a každá hodnota musí být platným objektem, který lze uložit ve vlastnosti odpovídajícího klíče.
Type: | System.Collections.Hashtable |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SCSession
Určuje připojení k serveru pro správu. Výchozí hodnota je aktuální připojení skupiny pro správu.
Můžete zadat objekt připojení skupiny pro správu vrácený rutinou Get-SCManagementGroupConnection
.
Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Třídu můžete řadit do parametru Třídy rutiny New-SCSMClassInstance , například objekt vrácený rutinou Get-SCClass .
Výstupy
Tato rutina negeneruje žádný výstup.