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 cmdlet 修改访问帐户的属性。 可以将用户或组添加到访问帐户，并将权限级别更改为他们有权访问的对象。

访问帐户是可以访问位于分发点上的已建立服务或应用程序的用户或组列表。 例如，软件更新点连接访问帐户中的成员可以访问两项服务来管理软件更新：Windows Server Update Services (WSUS) 和 WSUS Synchronization Manager。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 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
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-AccountType

指定帐户类型。 有效值为：Guest、User、WindowsGroup 和 WindowsUser。

类型:	AccessAccountType
接受的值:	User, Guest, Administrator, WindowsUser, WindowsGroup
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ApplicationId

指定应用程序的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ApplicationName

指定应用程序的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-BootImageId

指定启动映像的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-BootImageName

指定启动映像的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DriverPackageId

指定驱动程序包的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DriverPackageName

指定驱动程序包的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

类型:	IResultObject
别名:	DriverPackage, Application, OperatingSystemImage, OperatingSystemInstaller, Package, SoftwareUpdateDeploymentPackage, BootImage
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-OperatingSystemImageId

指定操作系统映像的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OperatingSystemImageName

指定操作系统映像的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OperatingSystemInstallerId

指定操作系统安装程序的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OperatingSystemInstallerName

指定操作系统安装程序的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-PackageId

指定已部署软件脚本或程序的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-PackageName

指定已部署软件脚本或程序的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SoftwareUpdateDeploymentPackageId

指定已部署软件更新的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SoftwareUpdateDeploymentPackageName

指定已部署软件更新的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-UserName

指定域\用户格式的 Windows 用户帐户名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	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