Set-CMAccessAccount

Модуль:

ConfigurationManager

Изменяет свойства учетной записи доступа.

Синтаксис

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   [-InputObject] <IResultObject>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -ApplicationId <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -ApplicationName <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -BootImageId <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -BootImageName <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -DriverPackageId <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -DriverPackageName <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -OperatingSystemImageId <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -OperatingSystemImageName <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -OperatingSystemInstallerId <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -OperatingSystemInstallerName <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -PackageId <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -PackageName <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   [-PassThru]
   -SoftwareUpdateDeploymentPackageId <String>
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   [-PassThru]
   -SoftwareUpdateDeploymentPackageName <String>
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-CMAccessAccount изменяет свойства учетной записи доступа. Вы можете добавить пользователей или группы в учетную запись доступа и изменить уровень разрешений на объекты, для которых у них есть разрешения.

Учетная запись доступа — это список пользователей или групп, которые могут получить доступ к установленной службе или приложению, расположенным в точке распространения. Например, члены учетной записи доступа к точке обновления программного обеспечения могут получить доступ к двум службам для управления обновлениями программного обеспечения: Windows Server Update Services (WSUS) и диспетчеру синхронизации WSUS.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Изменение доступа к пакету с помощью имени пакета

PS XYZ:\> $Name = Get-CMAccessAccount -PackageName "Configuration Manager Client Package"
PS XYZ:\> Set-CMAccessAccount -PackageName $Name -Type User -UserName "CONTOSO\PFuller" -Access Read -Confirm

Первая команда получает имя пакета, а затем сохраняет его в переменной $Name.

Вторая команда задает для пользователя разрешения на доступ к пакету read. Перед выполнением команды необходимо подтвердить действие.

Параметры

-Access

Указывает права доступа, связанные с учетной записью доступа. Допустимые значения: "Нет доступа", "Чтение", "Изменение" и "Полный доступ".

Тип:	AccessRight
Допустимые значения:	NoAccess, Read, Change, FullControl
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AccountType

Указывает тип учетной записи. Допустимые значения: Guest, User, WindowsGroup и WindowsUser.

Тип:	AccessAccountType
Допустимые значения:	User, Guest, Administrator, WindowsUser, WindowsGroup
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ApplicationId

Указывает идентификатор приложения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ApplicationName

Указывает имя приложения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BootImageId

Указывает идентификатор загрузочного образа.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BootImageName

Указывает имя загрузочного образа.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DriverPackageId

Указывает идентификатор пакета драйвера.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DriverPackageName

Указывает имя пакета драйвера.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

Тип:	IResultObject
Aliases:	DriverPackage, Application, OperatingSystemImage, OperatingSystemInstaller, Package, SoftwareUpdateDeploymentPackage, BootImage
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-OperatingSystemImageId

Указывает идентификатор образа операционной системы.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OperatingSystemImageName

Указывает имя образа операционной системы.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OperatingSystemInstallerId

Указывает идентификатор установщика операционной системы.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OperatingSystemInstallerName

Указывает имя установщика операционной системы.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PackageId

Указывает идентификатор развернутого программного скрипта или программы.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PackageName

Указывает имя развернутого программного скрипта или программы.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PassThru

Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SoftwareUpdateDeploymentPackageId

Указывает идентификатор развернутого обновления программного обеспечения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SoftwareUpdateDeploymentPackageName

Указывает имя развернутого обновления программного обеспечения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UserName

Указывает имя учетной записи пользователя Windows в формате домен\пользователь.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object

Связанные ссылки

• Get-CMAccessAccount
• New-CMAccessAccount
• Remove-CMAccessAccount
• Get-CMApplication
• Get-CMBootImage
• Get-CMDriverPackage
• Get-CMOperatingSystemImage
• Get-CMOperatingSystemInstaller
• Get-CMPackage
• Get-CMSoftwareUpdateDeploymentPackage