New-SCClassInstance
Добавляет экземпляр класса в базу данных.
Синтаксис
Default (по умолчанию)
New-SCClassInstance
[-Class] <ManagementPackClass>
[-PassThru]
[-Property] <Hashtable>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет New-SCClassInstance добавляет экземпляр класса в базу данных.
Примеры
Пример 1: Создание экземпляров класса принтера
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."
}
}
Эти команды создают набор из 10 экземпляров класса принтера с именами от Printer0 до Printer9. В качестве расположения задано значение "Contoso Headquarters", и все они связаны с именем сервера "ContosoPrintServer".
Параметры
-Class
Указывает класс, на котором основан новый экземпляр. Можно использовать командлет Get-SCClass для получения объекта ManagementPackClass , необходимого для этого параметра.
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ComputerName
Указывает компьютер, с которым необходимо установить соединение. На компьютере должна быть запущена служба доступа к данным System Center. Значением по умолчанию является компьютер для текущего подключения к группе управления.
Допустимые форматы включают имя NetBIOS, IP-адрес или полное доменное имя (FQDN). Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.).
Свойства параметра
| Тип: | System.String[] |
| Default value: | Localhost |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметра
| Тип: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает учетную запись пользователя, от имени которой будет выполняться подключение к группе управления. Учетная запись должна иметь доступ к серверу, указанному в параметре ComputerName , если сервер указан. Значение по умолчанию — текущий пользователь.
Вы можете ввести объект PSCredential , который возвращается командлетом Get-Credential .
Свойства параметра
| Тип: | System.Management.Automation.PSCredential |
| Default value: | Current user context |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PassThru
Указывает объект вывода, представляющий новый объект экземпляра класса. Этот объект вывода может быть передан другим командлетам.
Свойства параметра
| Тип: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Property
Хэш-таблица пар свойств-значение, представляющих значения свойств нового экземпляра. Каждый ключ хэш-таблицы должен быть именем допустимого свойства в классе, указанном в параметре Class , и каждое значение должно быть допустимым объектом, который может быть сохранен в свойстве соответствующего ключа.
Свойства параметра
| Тип: | System.Collections.Hashtable |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 2 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SCSession
Указывает подключение к серверу управления. Значением по умолчанию является текущее подключение к группе управления.
Можно ввести объект подключения к группе управления, возвращаемый командлетом Get-SCManagementGroupConnection .
Свойства параметра
| Тип: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметра
| Тип: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Вы можете передать класс в параметр Class командлета New-SCClassInstance , например объект, возвращаемый командлетом Get-SCClass .
Выходные данные
None
Этот командлет не создает выходные данные.