New-SCClassInstance
Dodaje wystąpienie klasy do bazy danych.
Składnia
Default (Domyślna)
New-SCClassInstance
[-Class] <ManagementPackClass>
[-PassThru]
[-Property] <Hashtable>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet New-SCClassInstance dodaje wystąpienie klasy do bazy danych.
Przykłady
Przykład 1: Tworzenie instancji klasy drukarki
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."
}
}
Te polecenia tworzą zestaw 10 instancji klasy drukarki o nazwach od Printer0 do Printer9. Lokalizacja jest ustawiona na "Siedziba główna firmy Contoso" i wszystkie są skojarzone z nazwą serwera "ContosoPrintServer".
Parametry
-Class
Określa klasę, na której jest oparte nowe wystąpienie. Za pomocą polecenia cmdlet Get-SCClass można uzyskać obiekt ManagementPackClass wymagany dla tego parametru.
Właściwości parametru
| Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ComputerName
Określa komputer, z którym ma zostać nawiązane połączenie. Na komputerze musi być uruchomiona usługa System Center Data Access. Wartość domyślna to komputer dla bieżącego połączenia grupy zarządzania.
Prawidłowe formaty obejmują nazwę NetBIOS, adres IP lub w pełni kwalifikowaną nazwę domeny (FQDN). Aby określić komputer lokalny, wpisz nazwę komputera, "localhost" lub kropkę (.).
Właściwości parametru
| Typ: | System.String[] |
| Domyślna wartość: | Localhost |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | System.Management.Automation.SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Credential
Określa konto użytkownika, w ramach którego będzie uruchamiane połączenie grupy zarządzania. Konto musi mieć dostęp do serwera określonego w parametrze NazwaKomputera , jeśli serwer jest określony. Wartość domyślna to bieżący użytkownik.
Możesz wprowadzić obiekt PSCredential zwracany przez polecenie cmdlet Get-Credential .
Właściwości parametru
| Typ: | System.Management.Automation.PSCredential |
| Domyślna wartość: | Current user context |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-PassThru
Określa obiekt wyjściowy reprezentujący nowy obiekt instancji klasy. Ten obiekt wyjściowy można przekazać do innych poleceń cmdlet.
Właściwości parametru
| Typ: | System.Management.Automation.SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Property
Tabela skrótów par właściwość-wartość reprezentująca wartości właściwości nowego wystąpienia. Każdy klucz tabeli skrótów musi być nazwą prawidłowej właściwości w klasie, która jest określona w parametrze Class , a każda wartość musi być prawidłowym obiektem, który może być przechowywany we właściwości odpowiadającego mu klucza.
Właściwości parametru
| Typ: | System.Collections.Hashtable |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 2 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-SCSession
Określa połączenie z serwerem zarządzania. Wartość domyślna to bieżące połączenie grupy zarządzania.
Można wprowadzić obiekt połączenia grupy zarządzania, który jest zwracany Get-SCManagementGroupConnection przez polecenie cmdlet.
Właściwości parametru
| Typ: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | System.Management.Automation.SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Klasę można potokować do parametru Class polecenia cmdlet New-SCClassInstance , na przykład obiektu zwracanego przez polecenie cmdlet Get-SCClass .
Dane wyjściowe
None
To polecenie cmdlet nie generuje żadnych danych wyjściowych.