New-SCSMClassInstance
Přidá instanci třídy do databáze.
Syntaxe
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řídy 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řídy 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 server ContosoPrintServer.
Parametry
-Class
Určuje třídu, na které je nová instance založena. Pomocí rutiny Get-SCClass můžete získat objekt ManagementPackClass požadovaný pro tento parametr.
Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
Position: | 1 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ComputerName
Určuje počítač, se kterým se má navázat připojení. Na počítači musí být spuštěná služba 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). Chcete-li zadat místní počítač, zadejte název počítače, "localhost" nebo tečku (.).
Typ: | System.String[] |
Position: | Named |
Default value: | Localhost |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny vás vyzve k potvrzení.
Typ: | System.Management.Automation.SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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 vrácený rutinou Get-Creden tial.
Typ: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | Current user context |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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.
Typ: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Property
Hashtable of property-value pairs representing the property values of the new instance. Každý klíč hashtable musí být název platné vlastnosti v rámci třídy, která je zadána v parametru Class a každá hodnota musí být platným objektem, který může být uložen ve vlastnosti odpovídajícího klíče.
Typ: | System.Collections.Hashtable |
Position: | 2 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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
.
Typ: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
Typ: | System.Management.Automation.SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Třídu můžete řadit do třídy parametru New-SCSMClassInstance, například objekt vrácený rutinou Get-SCClass.
Výstupy
Tato rutina negeneruje žádný výstup.