System Center 2016 – Data Protection Manager (DPM 2016) の DPM 管理シェルは、PowerShell を用いたコマンドライン インタフェースです。
DPM 管理シェルは、デスクトップ上のアイコン、もしくは [スタート メニュー] – [Microsoft System Center 2016] – [DPM 管理シェル] を選択、クリックすることで起動することが可能です。
DPM 2016 の管理を目的として様々なコマンドレットが DPM 管理シェルに用意されていますが、 コマンドレットのヘルプについては、日本語の情報は公開されていません。
このヘルプ情報について、「Get-Help」コマンドレットの -Full オプションを用いて実行した結果を編集、意訳しました。
この記事では、「Remove-DPMSecurityGroup」コマンドレットについて記載します (他のコマンドレットについては、「System Center 2016 – Data Protection Manager の DPM 管理シェルで使用できるコマンドレットについて」を参照)。
Remove-DPMSecurityGroup コマンドレット
名前
Remove-DPMSecurityGroup
概要
DPM ロールからセキュリティ グループを削除します。
構文
Remove-DPMSecurityGroup [-DpmRole] <DpmRole> [[-SecurityGroups] <String[]>] [-All] [-Confirm] [-WhatIf] [<CommonParameters>] |
説明
Remove-DPMSecurityGroup コマンドレットは、System Center 2016 – Data Protection Manager (DPM) ロールから 1 つ以上のセキュリティ グループを削除します。DPM ロールを指定するために、Get-DPMRole コマンドレットを使用することが可能です。変更を保存するには、Set-DPMRole コマンドレットを用います。
Get-DPMSecurityGroup コマンドレットを用いて DPM ロールのセキュリティ グループを参照することが可能です。また、DPM ロールにセキュリティ グループを追加するには、Add-DPMSecurityGroup コマンドレットを用います。
パラメーター
-All [<SwitchParameter>]
コマンドレットが参照するすべてのオブジェクトに対して実行する場合に指定します。
必須 | false |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-DpmRole <DpmRole>
このコマンドレットがセキュリティ グループを削除する DPM ロールを指定します。DPM ロール オブジェクトを取得するために、Get-DPMRole コマンドレットを用います。
必須 | true |
位置 | 1 |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-SecurityGroups [<String[]>]
セキュリティ グループの配列を指定します。このコマンドレットは、DPM ロールからこれらのグループを削除します。
必須 | false |
位置 | 2 |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-Confirm [<SwitchParameter>]
コマンドレットを実行する前に確認のプロンプトを表示します。
必須 | false |
位置 | named |
既定値 | false |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-WhatIf [<SwitchParameter>]
コマンドレットを実行する場合、何が起きるかを表示します。コマンドレットは実行されません。
必須 | false |
位置 | named |
既定値 | false |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-WarningAction、-WarningVariable、-OutBuffer、-PipelineVariable、および -OutVariable。詳細については、about_CommonParameters を参照してください。
入力
入力の種類は、コマンドレットにパイプ可能なオブジェクトの種類です。
出力
出力の種類は、コマンドレットが発行するオブジェクトの種類です。
例
例 1 : ロールからセキュリティ グループを削除します。
$DpmRole = Get-DPMRole -Name "OpsMgrSQL" -Editable Remove-DPMSecurityGroup -DpmRole $DpmRole -SecurityGroups "DpmDom02\Administrator"
最初のコマンドは、Get-DPMRole コマンドレットを用いてロール「OpsMgrSQL」を取得、変数 $DpmRole に格納します。このコマンドは、ロールを編集可能にします。
2 番目のコマンドは、$DpmRole のロールからセキュリティ グループ「DpmDom02\Administrator」を削除します。
関連するリンク
- Add-DPMSecurityGroup
- Get-DPMSecurityGroup
- Get-DPMRole
- Set-DPMRole
参考
- Data Protection Manager Cmdlets
https://technet.microsoft.com/en-us/library/hh881730(v=sc.30).aspx - Remove-DPMSecurityGroup
https://technet.microsoft.com/en-us/library/hh881764(v=sc.30).aspx