Share via

Remove-CMAccessAccount

  • Referência
Módulo:
ConfigurationManager

Remove usuários ou grupos de uma conta de acesso.

Syntax

Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      [-Force]
      [-InputObject] <IResultObject>
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      -ApplicationId <String>
      [-Force]
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      -ApplicationName <String>
      [-Force]
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      -BootImageId <String>
      [-Force]
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      -BootImageName <String>
      [-Force]
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      -DriverPackageId <String>
      [-Force]
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      -DriverPackageName <String>
      [-Force]
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      [-Force]
      -OperatingSystemImageId <String>
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      [-Force]
      -OperatingSystemImageName <String>
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      [-Force]
      -OperatingSystemInstallerId <String>
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      [-Force]
      -OperatingSystemInstallerName <String>
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      [-Force]
      -PackageId <String>
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      [-Force]
      -PackageName <String>
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      [-Force]
      -SoftwareUpdateDeploymentPackageId <String>
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAccessAccount
      -AccountType <AccessAccountType>
      [-Force]
      -SoftwareUpdateDeploymentPackageName <String>
      [-UserName <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-CMAccessAccount remove usuários ou grupos de 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 a 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: Remover um usuário de uma conta de acesso para um aplicativo usando seu nome

PS XYZ:\> Remove-CMAccessAccount -ApplicationName "SharePoint 2010" -Type WindowsUser -UserName "CONTOSO\ENarvaez" -Confirm

Esse comando remove um usuário Windows da conta de acesso para um aplicativo especificado usando seu nome. Você deve confirmar a ação antes que o comando a execute.

Exemplo 2: Remover um grupo de uma conta de acesso para um pacote usando sua ID

PS XYZ:\> $ID = Get-CMAccessAccount -PackageId "CM1100002"
PS XYZ:\> Remove-CMAccessAccount -PackageId $ID -Type WindowsGroup -UserName "CONTOSO\Guest"

O primeiro comando obtém a ID do objeto do pacote e a armazena na variável $ID.

O segundo comando remove um grupo da conta de acesso do pacote especificado. Nenhuma confirmação é necessária.

Parâmetros

-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

-Força

Força o comando a ser executado sem pedir confirmação do usuário.

Type:SwitchParameter
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:DriverPackage, Application, OperatingSystemImage, OperatingSystemInstaller, Package, SoftwareUpdateDeploymentPackage, BootImage
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

System.Object