New-CMAccessAccount
Adiciona usuários ou grupos a uma conta de acesso.
Syntax
New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
[-InputObject] <IResultObject>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-ApplicationId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-ApplicationName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-BootImageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-BootImageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-DriverPackageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-DriverPackageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-OperatingSystemImageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-OperatingSystemImageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-OperatingSystemInstallerId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-OperatingSystemInstallerName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-PackageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-PackageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-SoftwareUpdateDeploymentPackageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-SoftwareUpdateDeploymentPackageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O cmdlet New-CMAccessAccount adiciona usuários ou grupos a uma conta de acesso.
Uma conta de acesso é uma lista de usuários ou grupos que podem acessar um serviço ou aplicativo estabelecido localizado em um ponto de distribuição. Por exemplo, membros na conta de acesso de Conexão de Ponto de Atualização de Software podem acessar dois serviços para gerenciar atualizações de software: Windows Server Update Services (WSUS) e WSUS Synchronization Manager.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.
Exemplos
Exemplo 1: Modificar o acesso a um aplicativo usando a ID do aplicativo
PS XYZ:\> $ID = Get-CMAccessAccount -ApplicationID "12994680"
PS XYZ:\> New-CMAccessAccount -ApplicationID $ID -Type WindowsUser Username "CONTOSO\EDaugherty" -Access "FullControl"O primeiro comando obtém uma ID do aplicativo e, em seguida, armazena-a na variável $ID de aplicativo.
O segundo comando obtém o aplicativo identificado pelo $ID e adiciona um usuário à conta de acesso. As permissões do novo usuário são definidas como FullControl.
Parâmetros
-Access
Especifica os direitos de acesso associados a uma conta de acesso. Os valores válidos são: Sem Acesso, Leitura, Alteração e Controle Total.
| Type: | AccessRight |
| Accepted values: | NoAccess, Read, Change, FullControl |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AccountType
Especifica um tipo de conta. Os valores válidos são: Guest, User, WindowsGroup e WindowsUser.
| Type: | AccessAccountType |
| Accepted values: | User, Guest, Administrator, WindowsUser, WindowsGroup |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationId
Especifica a ID de um aplicativo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationName
Especifica o nome de um aplicativo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BootImageId
Especifica a ID de uma imagem de inicialização.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BootImageName
Especifica o nome de uma imagem de inicialização.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DriverPackageId
Especifica a ID de um pacote de driver.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DriverPackageName
Especifica o nome de um pacote de driver.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Especifica a entrada para este cmdlet. Você pode usar esse parâmetro ou pode canalizar a entrada para este cmdlet.
| Type: | IResultObject |
| Aliases: | Application, BootImage, DriverPackage, OperatingSystemImage, OperatingSystemInstaller, Package, SoftwareUpdateDeploymentPackage |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OperatingSystemImageId
Especifica a ID de uma imagem do sistema operacional.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperatingSystemImageName
Especifica o nome de uma imagem do sistema operacional.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperatingSystemInstallerId
Especifica a ID de um instalador do sistema operacional.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperatingSystemInstallerName
Especifica o nome de um instalador do sistema operacional.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageId
Especifica a ID de um script ou programa de software implantado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageName
Especifica o nome de um script ou programa de software implantado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SoftwareUpdateDeploymentPackageId
Especifica a ID de uma atualização de software implantada.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SoftwareUpdateDeploymentPackageName
Especifica o nome de uma atualização de software implantada.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserName
Especifica um nome Windows de conta de usuário no formato domínio\usuário.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
IResultObject